Docker 部署

官方镜像 kuingsmile/piclist 运行 Core HTTP 服务。镜像与桌面版本独立发布；部署后检查容器中安装的 Core 版本。

准备配置

创建一个私有配置目录，将已验证的 data.json 放入其中。容器中默认目录为 /root/.piclist。相册、字体或本地上传路径需要按容器实际路径调整。

启动本机服务

以下示例通过主机回环端口提供服务，在容器内监听 0.0.0.0，才能接收 Docker 转发的请求：

docker run -d \
  --name piclist \
  --restart unless-stopped \
  -p 127.0.0.1:36677:36677 \
  -v "./piclist:/root/.piclist" \
  kuingsmile/piclist:latest \
  node /usr/local/bin/picgo-server --host 0.0.0.0

使用 Compose

保存为 compose.yaml：

services:
  piclist:
    image: kuingsmile/piclist:latest
    restart: unless-stopped
    ports:
      - "127.0.0.1:36677:36677"
    volumes:
      - "./piclist:/root/.piclist"
    command:
      - node
      - /usr/local/bin/picgo-server
      - --host
      - "0.0.0.0"
      - --key
      - "${PICLIST_SERVER_KEY:?Set PICLIST_SERVER_KEY}"

在本机设置自己的 PICLIST_SERVER_KEY，或放入不提交到版本库的 .env 文件，再运行 docker compose up -d。Docker 转发的请求不一定属于服务视角的回环请求，因此客户端应传入同一密钥。

配置与验证

docker exec -it piclist picgo init
docker exec piclist picgo --version
docker restart piclist
curl http://127.0.0.1:36677/heartbeat

Compose 创建的容器可改用 docker compose exec piclist picgo init。修改配置或安装插件后重启服务。

远程客户端应使用 multipart 上传；客户端路径在容器里不存在。必须使用路径上传时，先显式挂载对应目录，再传入容器内的绝对路径。

更新

备份挂载目录，拉取镜像并重建容器。生产部署可将镜像固定到经过验证的摘要；latest 是可变标签，不等同于固定的 Core 版本。