Docker 部署教程：docker compose 一键起服务

适合谁

服务器部署、NAS 玩家，或者本机想要"开箱即用 + 更新只需拉镜像"的用户。官方提供预构建镜像，不需要自己在容器里跑安装流程。

最小可用 compose 示例

在你打算放数据的目录里建一个 docker-compose.yml：

services:
  luker:
    image: 官方预构建镜像（见仓库 README 提供的镜像地址）
    container_name: luker
    ports:
      - 127.0.0.1:8000:8000
    volumes:
      - ./plugins:/home/node/app/plugins
      - ./config:/home/node/app/config
      - ./data:/home/node/app/data
      - ./extensions:/home/node/app/public/scripts/extensions/third-party
    restart: unless-stopped

四个数据卷分别对应：服务端插件、配置文件、用户数据（角色卡 / 聊天 / 预设）、第三方前端扩展。数据都落在宿主机目录里，换容器不丢数据。

启动与更新

docker compose up -d

更新镜像：

docker compose pull
docker compose up -d

端口绑定与安全

默认把端口绑在 127.0.0.1:8000，只有本机能访问，这是安全默认值。如果你要从局域网或公网访问，把映射改成 0.0.0.0:8000:8000 之前，务必先做两件事：

• 反代 + HTTPS：用 Nginx 之类的前置代理提供加密
• 开启登录：Basic Auth 或多用户账户，防止陌生人白嫖你的 API 密钥——详见鉴权与安全设置

启动后浏览器访问 localhost:8000，接下来走首次配置走通。

镜像地址与 compose 字段以仓库根目录的最新 compose 文件为准。