etherpad/etherpad Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

Etherpad：Web实时协作编辑器

!Etherpad演示动画

概述

Etherpad是一款Web实时协作编辑器，可扩展支持数千名并发实时用户，提供完整的数据导出功能，并能在您自己的服务器上运行，完全由您掌控数据。

核心功能与特性

• 实时协作：多人同时编辑，实时显示各方更改
• 高可扩展性：支持数千并发用户（扩展测试）
• 数据导出：提供完整数据导出能力（了解详情）
• 自托管控制：运行在自有服务器，确保数据安全与隐私
• 插件生态：丰富的插件系统，支持功能高度自定义

使用场景

适用于团队协作编辑、文档共同创作、实时会议记录、多人协作撰稿等场景，尤其适合需要数据私有化和自主管理的组织或个人。

试用体验

• Wikimedia提供公共实例：试用Etherpad
• 其他公共实例：查看更多功能

项目状态

目前正在寻找维护者，并提供部分资金支持。如有兴趣，请联系John McLear。

代码质量

![代码质量]([] ![package.lock检查]([]

测试状态

![后端测试]([] ![模拟负载测试]([] ![速率限制测试]([] ![Docker文件测试]([] ![前端管理测试]([] ![前端测试]([] ![Sauce测试状态]([] ![Windows构建]([]

社区参与

![Docker拉取量]([] ![]([] ![Etherpad插件]([] !语言支持 !翻译覆盖率

Docker部署指南

基本运行命令

bash
docker run -d -p 9001:9001 --name etherpad etherpad/etherpad

Docker Compose配置示例

yaml
version: '3'
services:
  etherpad:
    image: etherpad/etherpad
    container_name: etherpad
    ports:
      - "9001:9001"
    volumes:
      - ./etherpad_data:/opt/etherpad-lite/var
    environment:
      - NODE_ENV=production
      - DB_TYPE=sqlite
      - DB_FILENAME=/opt/etherpad-lite/var/dirty.db
    restart: unless-stopped

更多详细配置请参考官方Docker文档

插件系统

Etherpad通过插件实现高度自定义功能。

!基础安装界面

!完整功能界面

可用插件

查看完整插件列表：Etherpad插件网站

插件安装方法

通过管理界面安装

访问Etherpad管理界面（如：[***]

通过命令行安装

bash
cd /path/to/etherpad-lite
# --no-save 和 --legacy-peer-deps 参数用于解决npm兼容性问题
npm install --no-save --legacy-peer-deps ep_${插件名称}

推荐插件组合

运行以下命令安装演示中展示的完整功能插件：

bash
npm install --no-save --legacy-peer-deps \
  ep_align \
  ep_comments_page \
  ep_embedded_hyperlinks2 \
  ep_font_color \
  ep_headings2 \
  ep_markdown \
  ep_webrtc

身份认证推荐插件

• ep_openid_connect：OpenID Connect认证
• ep_guest：访客账户管理（如只读权限）
• ep_user_displayname：用户显示名自动填充
• ep_stable_authorid：用户身份与属性关联

配置与优化

设置调整

Etherpad核心配置文件为settings.json，支持通过命令行参数指定不同配置文件：

bash
src/bin/run.sh --settings /path/to/custom-settings.json

主要配置参数：

• --credentials：指定设置覆盖文件
• --apikey：指定API密钥文件
• --sessionkey：指定会话密钥文件

所有配置参数均可通过环境变量设置，格式为${ENV_VAR}或${ENV_VAR:default_value}。

安全加固

生产环境建议：

1. 使用专用数据库（如MySQL）替代默认的dirtyDB
2. 安装ep_hash_auth插件存储密码哈希
3. 配置HTTPS加密传输

皮肤自定义

访问以下地址进行皮肤可视化定制：

[***]

!皮肤变体定制

开发资源

HTTP API

Etherpad提供HTTP API用于管理文档、用户和组，推荐使用官方客户端库进行交互。API的OpenAPI定义可通过/api/openapi.json访问。

jQuery插件

通过jQuery插件可轻松将Etherpad嵌入网站。

许可证

Apache License v2