NAS 自建图床完整实操手册：Lsky Pro + Docker
你为什么需要自建图床？
别人的服务器说关就关，你的 NAS 永远在线。图片数据 100% 自己掌控，零跑路风险，而且 0 月费。
一、硬件与环境要求
| 条件 | 最低要求 | 推荐配置 |
|---|
| NAS / 小主机 | 任何能跑 Docker 的设备 | 群晖 / 威联通 / Unraid / 绿联 / 树莓派 4B+ |
| 内存 | 1 GB 空闲 | 2 GB+ |
| 存储 | 10 GB 空闲 | 50 GB+（看你图片量） |
| Docker 环境 | Docker 20.x + Compose v2 | 最新版 |
| 外网访问（可选） | 公网 IPv4 或 IPv6 | 公网 IP + 自有域名 |
二、Docker 环境准备
如果你已经装了 Docker，直接跳到第三节。
2.1 群晖 NAS（DSM 7.x）
- 打开 套件中心
- 搜索 Container Manager（DSM 7.2+）或 Docker（DSM 7.1 及以下）
- 点击安装，等待完成
2.2 威联通 NAS（QNAP）
- 打开 App Center
- 搜索 Container Station
- 安装即可
2.3 绿联 NAS（UGOS）
- 打开 应用中心
- 搜索 Docker
- 安装
2.4 Linux 小主机 / 树莓派（通用）
# 安装 Docker
curl -fsSL https://get.docker.com | bash
# 安装 Docker Compose
sudo apt install docker-compose-plugin -y # Debian/Ubuntu
# 或
sudo yum install docker-compose-plugin -y # CentOS/RHEL
# 验证
docker --version
docker compose version
# 设置非 root 用户也能用 Docker（推荐）
sudo usermod -aG docker $USER
# 然后重新登录
2.5 Windows（WSL2 + Docker Desktop）
- 安装 WSL2：管理员 PowerShell 执行
wsl --install - 下载 Docker Desktop：https://www.docker.com/products/docker-desktop
- 安装后启动
三、部署 Lsky Pro（推荐 Docker Compose 方式）
我们使用 MySQL + Redis + Lsky Pro 三容器架构，这是生产环境推荐方案。
3.1 创建项目目录
# SSH 登录 NAS 或小主机，创建目录
mkdir -p /volume1/docker/lsky-pro
cd /volume1/docker/lsky-pro
📌 路径替换：群晖一般是 /volume2/docker/... 或 /volume1/docker/...，请改成你自己的路径。
3.2 编写 docker-compose.yml
nano docker-compose.yml
粘贴以下完整配置（⚠️ 务必修改密码）：
version: '3.8'
services:
# ========== MySQL 8.0 数据库 ==========
mysql:
image: mysql:8.0
container_name: lsky-mysql
restart: unless-stopped
environment:
MYSQL_ROOT_PASSWORD: LskyRoot2025! # ⚠️ 改成你自己的强密码
MYSQL_DATABASE: lsky
MYSQL_USER: lsky
MYSQL_PASSWORD: LskyUser2025! # ⚠️ 改成你自己的强密码
volumes:
- ./mysql-data:/var/lib/mysql
command:
- --default-authentication-plugin=mysql_native_password
- --character-set-server=utf8mb4
- --collation-server=utf8mb4_unicode_ci
networks:
- lsky-net
# ========== Redis 缓存 ==========
redis:
image: redis:7-alpine
container_name: lsky-redis
restart: unless-stopped
command: redis-server --appendonly yes --requirepass "LskyRedis2025!" # ⚠️ 改成你自己的密码
volumes:
- ./redis-data:/data
networks:
- lsky-net
# ========== Lsky Pro 图床主程序 ==========
lsky-pro:
image: 0xxb/lsky-pro:latest
container_name: lsky-pro
restart: unless-stopped
ports:
- "8000:8000" # 主机端口 : 容器端口
volumes:
- ./storage:/app/storage/app # 上传的图片存这里
- ./themes:/app/themes # 主题文件
environment:
DB_CONNECTION: mysql
DB_HOST: mysql
DB_PORT: 3306
DB_DATABASE: lsky
DB_USERNAME: lsky
DB_PASSWORD: LskyUser2025! # ⚠️ 跟上面 MYSQL_PASSWORD 保持一致
REDIS_HOST: redis
REDIS_PASSWORD: LskyRedis2025! # ⚠️ 跟上面 Redis 密码保持一致
REDIS_PORT: 6379
depends_on:
mysql:
condition: service_started
redis:
condition: service_started
networks:
- lsky-net
networks:
lsky-net:
driver: bridge
3.3 启动服务
docker compose up -d
# 查看是否全部启动成功（3 个容器都是 Up 状态）
docker compose ps
# 输出应该类似：
# NAME STATUS
# lsky-mysql Up (healthy)
# lsky-redis Up
# lsky-pro Up
四、初始化安装向导
4.1 访问安装页面
浏览器打开：http://你的NAS_IP:8000
例如：http://192.168.1.100:8000
4.2 填写数据库信息
Lsky Pro 安装向导会要求填入：
| 配置项 | 值 | 说明 |
|---|
| 数据库地址 | mysql | （容器名，不要填 localhost） |
| 数据库端口 | 3306 | MySQL 默认端口 |
| 数据库名称 | lsky | 和 docker-compose.yml 一致 |
| 数据库用户名 | lsky | 和 docker-compose.yml 一致 |
| 数据库密码 | LskyUser2025! | 和 docker-compose.yml 一致 |
4.3 设置管理员
| 配置项 | 说明 |
|---|
| 管理员邮箱 | 用于登录 + Token 获取 |
| 管理员密码 | ⚠️ 用强密码，这是图床的总钥匙 |
| 站点名称 | 随便填，比如"我的图床" |
4.4 点击安装
等待几秒 → 显示安装成功 → 自动跳转登录页。
用刚刚设置的管理员邮箱和密码登录。
五、配置存储策略（核心步骤）
登录后，左侧菜单 → 「储存」 → 「储存策略」 → 「新建储存策略」
5.1 本地存储（最简方案，图片直接存 NAS 硬盘）
| 配置项 | 值 |
|---|
| 角色组 | 勾选管理员组（后面再给普通用户组） |
| 名称 | 本地存储 |
| 存储驱动 | 本地（Local） |
| 文件命名规则 | {Y}/{m}/{d}/{md5}.{ext} |
| 访问域名 | 填你当前的访问地址（后续配了域名再改） |
| 文件路径 | /app/storage/app/uploads |
💡 文件命名建议：{Y}/{m}/{d}/{md5}.{ext} → 按年月日分文件夹，MD5 避免重名。
5.2 接入外部云存储（进阶，双重保险）
Lsky Pro 支持把图片直接存到云存储上，即使 NAS 挂了也能访问。
5.2.1 阿里云 OSS
| 配置项 | 值 |
|---|
| AccessKeyId | 阿里云 RAM 账号的 AccessKey |
| AccessKeySecret | 对应的 Secret |
| Bucket | 你的 OSS 桶名 |
| 地域节点（Endpoint） | oss-cn-hangzhou.aliyuncs.com（改成你的区域） |
| 自定义 CDN 域名 | CDN 加速域名（可选） |
5.2.2 腾讯云 COS
| 配置项 | 值 |
|---|
| SecretId | 腾讯云 API 密钥 SecretId |
| SecretKey | 对应的 SecretKey |
| Bucket | COS 桶名 + APPID（如 mybucket-1250000000） |
| 所属地域 | ap-guangzhou（改成你的区域） |
5.2.3 AWS S3 / Cloudflare R2 / MinIO
| 配置项 | 值 |
|---|
| AccessKeyId | S3 兼容密钥 |
| AccessKeySecret | 对应的 Secret |
| Bucket | 存储桶名 |
| 地域节点 | auto（R2 填 auto，真实 S3 填区域） |
六、PicGo 客户端配置（自动化上传）
6.1 获取 Lsky Pro 的 API Token
⚠️ 这是最关键的一步，Token 是 PicGo 连接图床的钥匙。
方法一：在 Lsky 后台直接获取（推荐）
- 登录 Lsky Pro 后台
- 「系统」 → 「接口」 → 查看接口地址
- 记录 API 基础 URL：
http://你的IP:8000/api/v1 - 用下面的工具生成 Token：
方法二：用 curl 命令获取（一条命令搞定）
curl -X POST "http://你的NAS_IP:8000/api/v1/tokens" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{"email":"你设置的管理员邮箱","password":"你设置的管理员密码"}'
返回示例：
{
"status": true,
"message": "success",
"data": {
"token": "1|aBcDeFgHiJkLmNoPqRsTuVwXyZ1234567890"
}
}
方法三：用 Postman（图形界面）
| 配置 | 值 |
|---|
| Method | POST |
| URL | http://你的NAS_IP:8000/api/v1/tokens |
| Headers | Accept: application/json
Content-Type: application/json |
| Body (raw JSON) | {"email":"admin@example.com","password":"your_password"} |
从响应中复制 token 的值（那一段长字符串）。
6.2 配置 PicGo
6.2.1 安装 Lsky 插件
- 打开 PicGo
- 左侧 → 「插件设置」
- 搜索框输入
lankong 或 lsky - 找到 lankong（或 lsky-pro）插件 → 点击「安装」
6.2.2 配置 Lsky 连接
PicGo → 「图床设置」 → 找到 「lankong」 或 「兰空图床」：
| 配置项 | 值 | 示例 |
|---|
| Server | 你的 Lsky 地址 | http://192.168.1.100:8000 |
| Auth Token | 上面获取的 token | `1 | aBcDeFgHiJkLmNoPqRsTuVwXyZ1234` |
| 策略 ID | 存储策略的 ID | 去 Lsky 后台 → 储存策略 → 看策略 ID 号 |
💡 策略 ID 可选填，不填则使用默认存储策略。
6.2.3 测试上传
- 拖一张图片到 PicGo 上传区
- 上传成功 → 链接自动复制
- 浏览器打开链接验证
七、Typora / Obsidian 自动上传集成
7.1 Typora 配置
- Typora → 文件 → 偏好设置 → 图像
- 插入图片时 → 选择 「上传图片」
- 上传服务 → 选择 「PicGo (app)」
- PicGo 路径 → 选 PicGo 安装目录（Windows 如
C:\Program Files\PicGo\PicGo.exe）
✅ 之后在 Typora 粘贴截图，会自动调用 PicGo → Lsky → 返回链接！
7.2 Obsidian 配置
- 社区插件搜
Image Auto Upload - 安装后在设置中选 PicGo
- 粘贴图片自动上传
7.3 VS Code 配置
安装 Paste Image 或 Markdown Image 插件，配置 PicGo 路径。
八、外网访问完整方案
图床建好了，但在公司想用？有三种方式让外面能访问到你的 NAS 图床。
8.1 方案 A：群晖 DDNS + 反向代理（有公网 IPv4，最推荐）
前提：确认你有公网 IPv4
# SSH 登录 NAS，查看你的公网 IP
curl ifconfig.me
然后登录路由器管理页，查看 WAN 口 IP。两个一致 = 有公网 IP。
步骤 1：配置群晖 DDNS
- 群晖 DSM → 控制面板 → 外部访问 → DDNS
- 点击「新增」
| 配置项 | 值 |
|---|
| 服务供应商 | Synology（免费送 xxx.synology.me 域名）
或选 阿里云 / 腾讯云 / Cloudflare（需自有域名） |
| 主机名称 | 如 mypic.synology.me |
| 用户名/密码 | 按提示填写 |
| 外部地址 | 保持 WAN 自动获取 |
- 点击「测试联机」→ 正常后点「确定」
步骤 2：申请 SSL 证书（HTTPS 必备）
- DSM → 控制面板 → 安全性 → 证书
- 点击「新增」→ 「从 Let's Encrypt 获取证书」
- 域名填
mypic.synology.me - 申请成功后，点「配置」→ 把对应服务绑上证书
步骤 3：配置反向代理
- DSM → 控制面板 → 登录门户 → 高级 → 反向代理服务器
- 点击「新增」：
| 来源 | 配置 |
|---|
| 协议 | HTTPS |
| 主机名 | mypic.synology.me |
| 端口 | 443 |
| HSTS | 勾选 |
| 目的地 | 配置 |
|---|
| 协议 | HTTP |
| 主机名 | localhost |
| 端口 | 8000 |
- 保存
步骤 4：路由器端口转发
登录路由器后台 → 端口转发 / 虚拟服务器 → 添加：
| 配置项 | 值 |
|---|
| 外部端口 | 443（HTTPS） |
| 内部 IP | 群晖的内网 IP（如 192.168.1.100） |
| 内部端口 | 443 |
| 协议 | TCP |
✅ 现在浏览器访问 https://mypic.synology.me 就能到你的图床了！
⚠️ 安全提示
- 别开 8000 端口！ 外网一律走 443（HTTPS）
- 把 PicGo 和 Typora 里的 Server 地址改成
https://mypic.synology.me
8.2 方案 B：公网 IPv6 + DDNS（没有 IPv4 时）
如果你的宽带只有 IPv6（移动宽带常见），也能用。
步骤 1：确认 IPv6
ip -6 addr show | grep global
# 有 240e:xxx 或 2409:xxx 开头的地址就是公网 IPv6
步骤 2：用 DDNS-GO 做动态解析
# Docker 部署 DDNS-GO
docker run -d \
--name ddns-go \
--restart=always \
--net=host \
-v /volume1/docker/ddns-go:/root \
jeessy/ddns-go
- 浏览器打开
http://你的NAS_IP:9876 - DNS 服务商选 阿里云 或 腾讯云 或 Cloudflare
- 填写 AccessKey → 输入你的域名
- IPv6 选择「通过接口获取」
- 保存
步骤 3：群晖反向代理（同方案A）
步骤 4：⚠️ 关键——客户端也需要 IPv6
只有访问你的设备也有 IPv6 时才能访问。手机用 4G/5G 一般都有 IPv6。
8.3 方案 C：内网穿透（啥公网都没有）
如果你没有公网 IP，只能用内网穿透。推荐三个：
| 服务 | 免费额度 | 速度 | 稳定性 |
|---|
| Cloudflare Tunnel | 免费无限 | 一般（海外中转） | ⭐⭐⭐⭐⭐ |
| frp（自建） | 免费（需一台云服务器） | 快 | ⭐⭐⭐⭐ |
| ZeroTier | 免费 25 设备 | 直连飞快 | ⭐⭐⭐ |
Cloudflare Tunnel 配置（推荐，完全免费）
- 登录 Cloudflare → Zero Trust → Tunnels
- 创建 Tunnel → 选 Docker 部署
- 运行命令（在你的 NAS 上）：
docker run -d \
--name cloudflared \
cloudflare/cloudflared:latest \
tunnel --no-autoupdate run \
--token 你的Tunnel_Token
在 Cloudflare Dashboard 配置 Public Hostname：
- 域名：
img.yourdomain.com - 服务：
http://lsky-pro:8000
✅ 现在 https://img.yourdomain.com 就能访问图床了！（Cloudflare 自动签发 SSL）
九、日常维护与安全
9.1 数据备份（一定要做！）
# 每天凌晨 3 点自动备份（加入 crontab）
# 备份数据库
docker exec lsky-mysql mysqldump -u lsky -p'LskyUser2025!' lsky \
> /volume1/backup/lsky/lsky_db_$(date +%Y%m%d).sql
# 备份图片文件
tar -czf /volume1/backup/lsky/lsky_images_$(date +%Y%m%d).tar.gz \
/volume1/docker/lsky-pro/storage/uploads/
# 只保留最近 30 天的备份
find /volume1/backup/lsky/ -name "*.tar.gz" -mtime +30 -delete
find /volume1/backup/lsky/ -name "*.sql" -mtime +30 -delete
9.2 版本更新
cd /volume1/docker/lsky-pro
docker compose down
docker compose pull # 拉取最新镜像
docker compose up -d # 重新启动
9.3 安全清单
| 事项 | 操作 |
|---|
| ✅ 管理员密码 | 12 位以上，包含大小写字母 + 数字 + 符号 |
| ✅ MySQL 密码 | 和 docker-compose.yml 里一样长就行 |
| ✅ 外网只开 443 | 路由器别暴露 8000/3306 端口 |
| ✅ SSL 证书 | Let's Encrypt 自动续期 |
| ✅ Token 管理 | 定期更换，泄露立刻删除重新生成 |
| ✅ 登录失败限制 | Lsky 后台 → 系统 → 安全设置 → 开启 |
9.4 容量管理
Lsky Pro 后台 → 用户 → 编辑用户 → 总容量，建议设置：
- 每个用户：2GB ~ 10GB（够用很久）
- 上传单文件限制：10MB（大部分图片 <10MB）
十、常见踩坑
| 问题 | 原因 | 解决 |
|---|
| 容器启动失败 | 端口冲突 | `netstat -tlnp \ | grep 8000` 检查 |
| 数据库连接失败 | 密码不一致 | 检查 docker-compose.yml 三处密码 |
| 安装时连不上数据库 | 地址填了 localhost | 改填 mysql（容器名） |
| 图片上传 404 | 存储路径权限 | chmod -R 755 ./storage |
| PicGo 上传超时 | 插件 URL 不对 | Server 后面不要带 /api/v1 |
| 反向代理 502 | 容器名解析不到 | 确保反向代理目的填 localhost:8000 |
| 外网访问不了 | 运营商封了 80/443 | 换个非标端口（如 8443），端口转发 |
| Token 获取失败 | 邮箱密码不对 | 用管理员邮箱 + 密码（不是 MySQL 密码） |
十一、方案总结
┌─────────────────────────────────────────────────────┐
│ Typora / Obsidian │
│ 粘贴图片，自动上传 │
└───────────────────────┬─────────────────────────────┘
│
▼
┌───────────────┐
│ PicGo │ ← lankong 插件 + Token
└───────┬───────┘
│ HTTP API
▼
┌─────────────────────────────────────────────────────┐
│ 你的 NAS │
│ ┌─────────────────────────────────────────────────┐│
│ │ Docker Compose ││
│ │ ┌─────────┐ ┌────────┐ ┌──────────────────┐ ││
│ │ │ MySQL │◄─┤ Lsky ├─►│ Redis │ ││
│ │ │ 8.0 │ │ Pro │ │ 7 │ ││
│ │ └─────────┘ └───┬────┘ └──────────────────┘ ││
│ │ │ 图片文件 ││
│ │ ┌──────▼──────┐ ││
│ │ │ 本地硬盘 │ ← /volume1/... ││
│ │ └─────────────┘ ││
│ └─────────────────────────────────────────────────┘│
└───────────────────────┬─────────────────────────────┘
│ 反向代理 + SSL
▼
┌─────────────────┐
│ https://域名 │ ← 外网访问
└─────────────────┘
│ (可选)
┌─────────────┼─────────────┐
▼ ▼ ▼
阿里云 OSS Cloudflare R2 腾讯云 COS
(远程备份) (远程备份) (远程备份)
图片存在你自己的硬盘上，域名是你的，SSL 是你的，一切都在你手里。没有月费，没有数据审查，不会跑路。