群晖 Container Manager 部署 Lsky Pro（兰空图床）实战笔记

适用：群晖 DSM 7.x + Container Manager（原 Docker）
方案：MariaDB 双容器（推荐，多用户/长期使用）
镜像：<code>halcyonazure/lsky-pro-docker:latest</code>（社区镜像，开源版官方无 Docker 镜像）

一、前置确认（动手前必看）

镜像要点（决定你怎么填端口）：

• 容器内 Apache 监听端口由 <code>WEB_PORT</code> 控制，默认 8089；
• 程序目录 <code>/var/www/html</code>；
• 端口映射右侧必须等于 <code>WEB_PORT</code>，否则页面打不开。

二、目录与权限准备（权限是 90% 故障根源）

1. File Station 新建：

   /volume1/docker/lsky-pro/
   ├── web/     # Lsky 程序 + 上传的图片
   └── db/      # MariaDB 数据（方案 B 才需要）

2. 设置权限（关键）：右键 <code>lsky-pro</code> → 属性 → 权限 → <code>Everyone</code> 设为可读写 →
   勾选「应用到这个文件夹、子文件夹及文件」。
   或 SSH 执行：

   sudo chmod -R 777 /volume1/docker/lsky-pro

⚠️ MariaDB 容器内以 uid 999（mysql 用户） 运行。若挂载目录属主是 root/admin，
容器内无写权限 → 无法初始化系统表 → 启动失败 → 无限重启（crash loop）。

三、方案选择

方案 A：SQLite 单容器（个人自用，最省事）

version: "3"

services:
  lsky-pro:
    image: halcyonazure/lsky-pro-docker:latest
    container_name: lsky-pro
    restart: unless-stopped
    ports:
      - "8089:8089"          # 左=群晖端口(可改)；右必须等于 WEB_PORT
    environment:
      TZ: Asia/Shanghai
      WEB_PORT: 8089
    volumes:
      - /volume1/docker/lsky-pro/web:/var/www/html

安装时数据库选 SQLite，数据库文件自动落在 <code>/var/www/html/database/</code>。

方案 B：MariaDB 双容器（推荐）

version: "3.8"

services:
  lsky-pro:
    image: halcyonazure/lsky-pro-docker:latest
    container_name: lsky-pro
    restart: unless-stopped
    depends_on:
      - mariadb                 # 列表形式，不带 condition
    environment:
      TZ: Asia/Shanghai
      WEB_PORT: 8089
    ports:
      - "8089:8089"
    volumes:
      - ./app:/var/www/html
    networks:
      - lsky-net

  mariadb:
    image: mariadb:10.11
    container_name: lsky-pro-db
    restart: unless-stopped
    command: --character-set-server=utf8mb4 --collation-server=utf8mb4_unicode_ci
    environment:
      TZ: Asia/Shanghai
      MARIADB_ROOT_PASSWORD: LskyRoot@2024     # 自行修改
      MARIADB_DATABASE: lskypro
      MARIADB_USER: lskypro
      MARIADB_PASSWORD: LskyDb@2024            # 自行修改
    volumes:
      - ./data:/var/lib/mysql
    networks:
      - lsky-net
    healthcheck:                              # 用 condition 时必须配
      test: ["CMD", "healthcheck.sh", "--connect", "--innodb_initialized"]
      interval: 10s
      timeout: 5s
      retries: 10
      start_period: 30s

networks:
  lsky-net:
    driver: bridge

若镜像无 <code>healthcheck.sh</code>，改用：
<code>test: ["CMD-SHELL", "mysqladmin ping -h 127.0.0.1 -u root -p$$MARIADB_ROOT_PASSWORD –silent"]</code>
（<code>$$</code> 是 Compose 转义，进容器后变 <code>$</code>）

四、Container Manager 部署步骤

1. Container Manager → 左侧「项目」→ 新增
2. 项目名称 <code>lsky-pro</code>；路径选 <code>/volume1/docker/lsky-pro</code>
3. 源：选「创建 docker-compose.yml」，粘贴上面的 yaml
4. 下一步 → 完成（自动拉镜像并构建）
5. 等 <code>lsky-pro-db</code> 状态变 Up/healthy，日志出现
   <code>[Note] mysqld: ready for connections.</code>（首次初始化 30~60 秒）
6. 浏览器打开 <code>http://群晖IP:8089</code> 进入安装向导

五、安装向导填参（最容易填错的一步）

为什么不能填 127.0.0.1：在 lsky-pro 容器里 <code>127.0.0.1</code> 指向它自己，
它只有 Apache+PHP，没有 MySQL → 必报 <code>SQLSTATE[HY000] [2002] Connection refused</code>。

六、装完必做

1. 存储策略 → 默认本地策略 → 编辑 → 访问地址 改成实际访问地址
   （<code>http://群晖IP:8089</code> 或反代域名），否则图片链接前缀错误 → 图片 404。
2. 自用建议：用户 → 关闭「允许注册」；角色组 → 关闭「游客上传」。
   

   我是在旁路由中使用Lucky管理反代

   七、排错速查表

八、核心三句话

1. 空目录（首次启动要初始化程序）
2. 给权限（Everyone 可读写 / MariaDB 目录 <code>chown 999:999</code>）
3. 端口右侧 = <code>WEB_PORT</code>，数据库地址填容器名