部署文档

用 Docker 部署极私语服务端

一条命令拉起服务端,数据集中在 ./data,备份迁移只拷一个目录。

最后更新:2026-10-06

镜像地址

国内镜像与源镜像内容完全一致,标签通用。国内主机把 image 换成国内镜像即可,拉取更快。

  • 国内:swr.cn-east-3.myhuaweicloud.com/jisiyu/jisiyu:latest
  • 国际:zhuchengji1990/jisiyu:latest

用 Docker Compose 部署(推荐)

新建 docker-compose.yml,写入以下内容后启动。restart: unless-stopped 保证开机自启与异常重启。

services:
  im-server:
    image: swr.cn-east-3.myhuaweicloud.com/jisiyu/jisiyu:latest
    pull_policy: always
    container_name: jisiyu
    restart: unless-stopped
    ports:
      - "${SERVER_PORT:-9009}:9009"
    environment:
      - TZ=Asia/Shanghai
    volumes:
      - ./etc:/app/etc/override:ro
      - ./data:/app/data
      - ./data/logs:/app/logs
      - /etc/machine-id:/etc/machine-id:ro

启动与停止

在 docker-compose.yml 所在目录执行:

docker compose up -d   # 启动
docker compose down    # 停止

用 docker run 部署

不使用 Compose 时,可以用单条 docker run 命令达到同样效果:

docker run -d \
  --name jisiyu \
  --restart unless-stopped \
  -p 9009:9009 \
  -e TZ=Asia/Shanghai \
  -v "$(pwd)/etc:/app/etc/override:ro" \
  -v "$(pwd)/data:/app/data" \
  -v "$(pwd)/data/logs:/app/logs" \
  -v "/etc/machine-id:/etc/machine-id:ro" \
  swr.cn-east-3.myhuaweicloud.com/jisiyu/jisiyu:latest

常见问题

国内服务器拉取镜像很慢怎么办?

把 docker-compose.yml 里的 image 换成国内镜像 swr.cn-east-3.myhuaweicloud.com/jisiyu/jisiyu:latest。国内镜像与源镜像内容完全一致,标签通用。

服务端怎么实现开机自启和异常自动重启?

Compose 里的 restart: unless-stopped 已经覆盖这两种情况:宿主机重启后容器自动拉起,进程异常退出也会自动重启。

为什么要把 /etc/machine-id 挂载进容器?

它只读挂载用于设备绑定(机器码)。缺少这个挂载时,容器重建后机器标识可能变化,影响授权绑定。

其他部署文档