CMS 配置指南

环境变量配置

基础配置

变量名	说明	默认值	必填
`PUID`	用户 ID	0	否
`PGID`	用户组 ID	0	否
`UMASK`	文件权限掩码	022	否
`TZ`	时区设置	Asia/Shanghai	否
`RUN_ENV`	运行环境	online	否

管理员配置

变量名	说明	默认值	必填
`ADMIN_USERNAME`	管理员用户名	admin	是
`ADMIN_PASSWORD`	管理员密码	admin	是（建议修改）

API 配置

变量名	说明	默认值	必填
`CMS_API_TOKEN`	API 认证令牌	cloud_media_sync	是（建议修改）

Emby 集成配置

变量名	说明	默认值	必填
`EMBY_HOST_PORT`	Emby 服务器地址	http://172.17.0.1:8096	是
`EMBY_API_KEY`	Emby API 密钥	xxx	是

捐赠码配置

变量名	说明	默认值	必填
`DONATE_CODE`	捐赠码（可选）	空	否

配置示例

完整配置示例

environment:
  # 基础配置
  - PUID=0
  - PGID=0
  - UMASK=022
  - TZ=Asia/Shanghai
  - RUN_ENV=online
  
  # 管理员配置（请修改为安全密码）
  - ADMIN_USERNAME=admin
  - ADMIN_PASSWORD=your_secure_password
  
  # API 配置（请修改为随机字符串）
  - CMS_API_TOKEN=your_random_api_token
  
  # Emby 配置
  - EMBY_HOST_PORT=http://172.17.0.1:8096
  - EMBY_API_KEY=your_emby_api_key
  
  # 捐赠码（可选）
  - DONATE_CODE=your_donate_code

完整 compose.yml 配置示例

services:
  cloud-media-sync:
    privileged: true
    container_name: cloud-media-sync
    image: jifav13945/cms-patched:latest
    restart: always
    network_mode: bridge
    volumes:
      - "./config:/config"
      - "./logs:/logs"
      - "./cache:/var/cache/nginx/emby"
      - "/data/media:/media"
    ports:
      - "9527:9527"
      - "9096:9096"
    environment:
      - PUID=0
      - PGID=0
      - UMASK=022
      - TZ=Asia/Shanghai
      - RUN_ENV=online
      - ADMIN_USERNAME=admin
      - ADMIN_PASSWORD=your_secure_password
      - CMS_API_TOKEN=your_random_api_token
      - EMBY_HOST_PORT=http://172.17.0.1:8096
      - EMBY_API_KEY=your_emby_api_key
      - DONATE_CODE=your_donate_code

注意:

请根据实际情况修改 ADMIN_PASSWORD、CMS_API_TOKEN、EMBY_API_KEY 等敏感信息
EMBY_HOST_PORT 中的 172.17.0.1 是 Docker 默认网关，如果 Emby 在其他位置，请相应修改
/data/media:/media 路径请根据实际媒体文件存储位置修改

安全建议

修改默认密码: 务必修改 ADMIN_PASSWORD 为强密码
修改 API Token: 将 CMS_API_TOKEN 设置为随机字符串
保护 API 密钥: 妥善保管 EMBY_API_KEY
使用 HTTPS: 生产环境建议使用反向代理配置 HTTPS

配置文件位置

配置文件位于容器内的 /config 目录，映射到宿主机的 ./config 目录。

日志查看

日志文件位于 ./logs 目录，可以通过以下命令查看：

# 查看实时日志
docker compose logs -f cloud-media-sync

# 查看日志文件
tail -f logs/cms.log

常见配置问题

1. Emby 连接失败

检查 EMBY_HOST_PORT 是否正确
确认 Emby 服务是否运行
验证 EMBY_API_KEY 是否有效

2. API 认证失败

确认 CMS_API_TOKEN 配置正确
检查请求头中的认证信息

3. 权限问题

检查 PUID 和 PGID 是否正确
确认数据卷挂载权限

下一步

配置完成后，可以开始使用 CMS 进行媒体库同步。如遇问题，请查看常见问题。