tozd/etherpad

tozd/etherpad

<[***]>

可用镜像地址：

• https://hub.docker.com/r/tozd/etherpad%EF%BC%88Docker Hub）
• registry.gitlab.com/tozd/docker/etherpad（GitLab Registry）

镜像继承关系

tozd/base ← tozd/dinit ← tozd/etherpad

标签

• latest: 对应Etherpad Lite v1.8.18版本

镜像概述和主要用途

本镜像提供https://github.com/ether/etherpad-lite%EF%BC%88%E8%BD%BB%E9%87%8F%E7%BA%A7%E5%AE%9E%E6%97%B6%E5%8D%8F%E4%BD%9C%E7%BC%96%E8%BE%91%E5%B7%A5%E5%85%B7%EF%BC%89%E7%9A%84Docker%E5%8C%96%E9%83%A8%E7%BD%B2%E6%96%B9%E6%A1%88%E3%80%82Etherpad%E6%94%AF%E6%8C%81%E5%A4%9A%E4%BA%BA%E5%AE%9E%E6%97%B6%E5%8D%8F%E4%BD%9C%E7%BC%96%E8%BE%91%E5%90%8C%E4%B8%80%E6%96%87%E6%A1%A3%EF%BC%8C%E6%89%80%E6%9C%89%E6%9B%B4%E6%94%B9%E5%AE%9E%E6%97%B6%E5%90%8C%E6%AD%A5%E3%80%82%E8%AF%A5%E9%95%9C%E5%83%8F%E7%AE%80%E5%8C%96%E4%BA%86Etherpad%E7%9A%84%E9%83%A8%E7%BD%B2%E6%B5%81%E7%A8%8B%EF%BC%8C%E6%94%AF%E6%8C%81%E9%80%9A%E8%BF%87%E9%85%8D%E7%BD%AE%E6%96%87%E4%BB%B6%E6%88%96%E7%8E%AF%E5%A2%83%E5%8F%98%E9%87%8F%E7%81%B5%E6%B4%BB%E5%AE%9A%E5%88%B6%EF%BC%8C%E9%80%82%E7%94%A8%E4%BA%8E%E5%9B%A2%E9%98%9F%E5%8D%8F%E4%BD%9C%E3%80%81%E4%BC%9A%E8%AE%AE%E8%AE%B0%E5%BD%95%E3%80%81%E5%85%B1%E5%90%8C%E7%BC%96%E8%BE%91%E7%AD%89%E5%9C%BA%E6%99%AF%E3%80%82

核心功能和特性

• 基于可靠基础镜像：构建于tozd/dinit和tozd/base镜像之上，确保基础环境稳定性
• 版本明确：latest标签对应Etherpad Lite v1.8.18，版本可控
• 灵活日志配置：支持日志输出到stdout（便于Docker日志管理）或文件卷
• 标准端口暴露：默认暴露9001/tcp端口，便于网络访问
• 多方式配置：支持挂载自定义配置文件或通过环境变量动态配置

使用场景和适用范围

• 团队实时协作编辑文档
• 多人共同撰写会议记录或报告
• 教学场景中师生实时互动编辑
• 需要快速部署协作编辑工具的临时项目

使用方法和配置说明

镜像获取

从Docker Hub拉取：

bash
docker pull tozd/etherpad

从GitLab Registry拉取：

bash
docker pull registry.gitlab.com/tozd/docker/etherpad

Docker Run部署示例

bash
docker run -d \
  --name etherpad \
  -p 9001:9001 \  # 映射HTTP端口到主机
  -v /path/to/settings.json:/etherpad/settings.json \  # 挂载自定义配置文件（可选）
  -e LOG_TO_STDOUT=1 \  # 日志输出到stdout（可选）
  tozd/etherpad

Docker Compose配置示例

yaml
version: '3'
services:
  etherpad:
    image: tozd/etherpad
    container_name: etherpad
    ports:
      - "9001:9001"  # 主机端口:容器端口
    volumes:
      # 挂载自定义配置文件（可选）
      - ./settings.json:/etherpad/settings.json
      # 若不使用LOG_TO_STDOUT=1，挂载日志卷（可选）
      # - etherpad_logs:/var/log/etherpad
    environment:
      - LOG_TO_STDOUT=1  # 日志输出到stdout（可选）
    restart: unless-stopped

# 日志卷定义（当LOG_TO_STDOUT未设置时使用）
# volumes:
#   etherpad_logs:

配置详情

卷（Volumes）

• /var/log/etherpad: 日志存储目录。当LOG_TO_STDOUT未设置为1时，Etherpad日志将写入此目录下的文件。

环境变量（Variables）

• LOG_TO_STDOUT: 日志输出控制。设为1时，日志输出到容器stdout（可通过docker logs <容器名>查看）；未设置时，日志写入/var/log/etherpad卷。所有stdout输出为JSON格式。

端口（Ports）

• 9001/tcp: Etherpad服务监听的HTTP端口，需通过-p参数映射到主机端口以对外提供服务。

配置文件定制

可将自定义的settings.json文件挂载到容器内/etherpad/settings.json路径，覆盖默认配置。若未挂载配置文件，首次运行时将使用https://github.com/tozd/etherpad-lite/blob/develop/settings.json.template%EF%BC%8C%E5%B9%B6%E9%80%9A%E8%BF%87%E7%8E%AF%E5%A2%83%E5%8F%98%E9%87%8F%E6%9B%BF%E6%8D%A2%E6%A8%A1%E6%9D%BF%E4%B8%AD%E7%9A%84%E5%8F%82%E6%95%B0%EF%BC%88%E5%85%B7%E4%BD%93%E7%8E%AF%E5%A2%83%E5%8F%98%E9%87%8F%E5%8F%AF%E5%8F%82%E8%80%83%E6%A8%A1%E6%9D%BF%E5%86%85%E5%AE%B9%EF%BC%89%E3%80%82

GitHub镜像

项目提供只读GitHub镜像：https://github.com/tozd/docker-etherpad%EF%BC%8C%E6%96%B9%E4%BE%BF%E5%9C%A8GitHub%E4%B8%8Afork%E9%A1%B9%E7%9B%AE%E3%80%82