nicholaswilde/etherpad

Docker Etherpad镜像说明

镜像概述

该镜像基于Alpine Linux构建，旨在提供轻量、多架构支持的Etherpad在线协作编辑平台。相比官方镜像，它体积更小，同时保留了Etherpad的核心功能，支持快速部署和自定义配置。

核心功能

1. 实时协作编辑：多人同时编辑文档，内容同步更新
2. 多架构支持：适配多种硬件架构（如arm64、amd64等）
3. 自定义配置：通过环境变量或自定义settings.json调整实例设置
4. 插件扩展：支持集成第三方插件增强功能
5. 多数据库适配：支持Postgres、MySQL等数据库存储数据

使用场景

• 团队协作：多人共同编辑项目文档、会议记录
• 在线教育：师生实时协作完成作业或笔记
• 远程办公：团队成员同步编辑方案或报告

配置说明

环境变量配置

可通过环境变量调整实例参数，部分常用变量如下：

构建自定义镜像

添加插件

构建时通过ETHERPAD_PLUGINS参数指定插件列表：

bash
docker build --build-arg ETHERPAD_PLUGINS="ep_comments_page ep_author_neat" --tag your-username/etherpad .

自定义设置

编辑settings.json.docker文件后重新构建镜像，该文件会被复制为容器内的settings.json。

部署示例

拉取镜像

bash
# 拉取最新版本
docker pull nicholaswilde/etherpad
# 拉取指定版本
docker pull nicholaswilde/etherpad:1.8.6

运行实例

基础运行

bash
docker run --detach --publish 9001:9001 nicholaswilde/etherpad

访问http://你的IP:9001即可使用。

启用管理员账户

bash
docker run -d \
  --name etherpad \
  -p 9001:9001 \
  -e 'ADMIN_PASSWORD=your-secret-password' \
  nicholaswilde/etherpad

使用Postgres数据库

bash
docker run -d \
  --name etherpad \
  -p 9001:9001 \
  -e 'DB_TYPE=postgres' \
  -e 'DB_HOST=postgres-host' \
  -e 'DB_PORT=5432' \
  -e 'DB_NAME=etherpad' \
  -e 'DB_USER=db-user' \
  -e 'DB_PASS=db-password' \
  nicholaswilde/etherpad

持久化存储（使用DirtyDB）

bash
docker run -d \
  -v etherpad_data:/opt/etherpad-lite/var \
  -p 9001:9001 \
  nicholaswilde/etherpad