프로젝트 소개

Etherpad는 저자와 이력이 중요한 문서를 위해 설계된 실시간 공동 문서 편집기입니다. 2009년부터 소규모 자원봉사 팀에 의해 유지 관리되어 왔으며 Apache License v2로 배포됩니다. README에 설명된 핵심 기능: - 실시간 공동 편집: 모든 키 입력이 작성자에게 귀속되고 작성자 색상이 인라인으로 표시됩니다. - 전체 개정 기록 보존: 문자 단위로 문서의 이력을 탐색할 수 있는 타임슬라이더가 포함됩니다. - 내장 전체 데이터 내보내기: 운영자가 문서 이력을 계속 접근할 수 있습니다. - 자체 호스팅 운영: 프로젝트는 텔레메트리와 추가 판매(업셀)가 없으며, AI 기능은 운영자가 선택한 모델을 가리키는 플러그인을 통해 선택적으로 활성화된다고 명시합니다. PRIVACY.md 문서는 Etherpad 자체 코드가 수행하는 두 가지 옵트아웃 네트워크 호출을 설명합니다. - 확장성 주장: 프로젝트는 패드당 수천 명의 동시 편집자를 지원함을 나타내는 스케일 테스트 페이지를 링크합니다. - 국제화: 주로 TranslateWiki를 통해 105개 언어로 번역되었습니다. - 확장성: 관리 웹 인터페이스나 명령줄에서 설치 가능한 수백 개의 플러그인을 제공하는 플러그인 사이트가 있는 플러그인 프레임워크가 있습니다. - 임베드 가능: /api/openapi.json에 OpenAPI 정의가 제공되는 패드헨을 관리하기 위한 HTTP API와, 웹 사이트에 패드를 삽입하기 위한 jQuery 플러그인이 포함됩니다. README에서 다루는 설치 옵션: - macOS/Linux/WSL(셸) 및 Windows(PowerShell)용 원라인 설치 스크립트: 저장소 복제, 의존성 설치, 프론트엔드 빌드를 수행합니다. Node.js >= 24와 git이 필요합니다. 환경 변수를 설정하면 설치 후 시작까지 한 단계로 진행할 수 있습니다. - Docker Compose 예제: Docker Hub 및 GitHub Container Registry에 게시된 공식 이미지, PostgreSQL 서비스, 플러그인 및 var 데이터를 위한 영구 볼륨, 관리자 비밀번호, 데이터베이스 연결 및 기타 설정을 위한 환경 변수를 포함합니다. - 수동 단계: pnpm 설치, 저장소 복제, pnpm i 실행, pnpm run build:etherpad 실행 후 pnpm run prod 실행, localhost:8081로 접속. 구성 및 관리: - 설정 파일은 settings.json에 있으며, 대체 설정 파일, 자격 증명 재정의, API 키 및 세션 키 파일, ${ENV_VAR} 또는 ${ENV_VAR:기본값} 구문을 사용한 환경 변수 대체를 지원합니다. - 설정은 /admin 웹 인터페이스를 통해서도 변경할 수 있습니다. - README는 프로덕션 환경에서 MySQL 또는 PostgreSQL과 같은 전용 데이터베이스 사용을 권장하며, dirtyDB 드라이버는 테스트 또는 개발용으로만 설계되었습니다. - 인증에는 평문 비밀번호 대신 해시 저장을 권장하며, ep_hash_auth 플러그인을 지정합니다. - OpenID Connect 인증을 위한 권장 플러그인으로는 ep_openid_connect, ep_guest, ep_displayname, ep_stable_authorid가 있습니다. - 더 풍부한 편집 기능을 위한 권장 플러그인 세트로는 ep_align, ep_comments_page, ep_embedded_hyperlinks2, ep_font_color, ep_headings2, ep_markdown, ep_webrtc가 있습니다. - 스킨 변형은 skinvariantsbuilder URL로 살펴볼 수 있습니다. 개발 및 프로젝트 상태: - bin/debugRun.sh로 디버깅, bin/fastRun.sh로 종속성 업데이트를 건너뛰는 빠른 시작 스크립트 제공. - 실시간 동작의 기반이 되는 Easysync 라이브브러리는 저장소에 있는 PDF로 문서화되어 있습니다. - 기여자 지침은 CONTRIBUTING.md에 제공됩니다. - README는 프로젝트가 현재 Node.js, 실시간 시스템또는 기관 공동 작업 도구에 대한 경험이 있는 유지관리자를 적극적으로 찾고 있다고 밝힙니다. - CI 배지에는 코드 품질(CodeQL), 백엔드 테스트, 시뮬레이션 부하, rate limit, Docker, 프론트엔드/관리 테스트가 포함됩니다. 명시된 사용자로는 위키미디어 재단, 유럽연합의 공공 부문 기관, 대학과 학교, 시민 기술 및 공론화 프로젝트, 뉴스룸, 그리고 많은 자체 호스팅 인스턴스가 있습니다. 소트프웨어를 체험할 수 있는 공개 인스턴스도 제공됩니다. 지원 채널: GitHub 이슈, Discord 서버, 책임 있는 취약점 공개를 위한 이메일 주소입니다.