3600 字
18 分钟
Lsky Pro 兰空图床:自建图床与博客配图工作流
2026-11-15

先说问题:文章里的图片,凭什么寄人篱下#

写博客、发帖子都绕不开配图。最省事的做法是把图片传到第三方图床,或者干脆引用别家网站的图片链接。省事的代价是:你的文章寿命,被别人的服务器决定了。

这类教训这些年一再重演:

  • 免费图床说关就关。运营方成本撑不住、政策变了、域名到期了,图片一夜之间全部变裂图,文章还躺在那里,配图已经没了。
  • 大厂图床搞防盗链。某社交平台的图片外链先是加 Referer 校验,后来直接 403,几年间无数博客的配图集体失效,只能一篇篇回头修。
  • 引用别人站点的图片更不可控。对方改版、删图、换域名,你的文章就跟着遭殃,而且你连通知都不会收到。

图床这件事的本质是:图片文件不大、流量不高,完全在个人 VPS 的能力范围内,没必要把命门交出去。自建图床的核心价值就一句话:链接永远长在自己的域名上,文件永远躺在自己的磁盘里。

本篇主线:Compose 部署 Lsky Pro → 配存储策略 → 关好权限防滥用 → PicGo 对接实现一键上传 → 串起博客与发帖的供图工作流 → 把数据备好。

选型:为什么是 Lsky Pro#

自建图床的常见选择,先拉个表对齐一下:

方案数据库存储后端权限/用户组API 上传适合场景
Lsky Pro(兰空)MySQL / SQLite本地、S3、OSS、COS、WebDAV 等多种有,多用户组配额有,Token 鉴权个人到小团队的正经图床
EasyImage无仅本地弱有极简自用,不想维护数据库
CheveretoMySQL本地、S3 等有有英文社区老牌,中文生态弱
对象存储+静态托管无单一云存储靠云厂商策略靠 SDK图片量大、愿意绑一家云
Git 仓库当图床无仓库无靠 Git 操作玩票,仓库膨胀后很难受

Lsky Pro 是国内开源图床里维护最久的一批:PHP 开发,后台中文,多存储策略、多用户组、相册管理、水印、API Token 一应俱全,正好卡在「个人用不过剩、团队用也够」的点上。本篇以开源版 V2 为准,Docker 镜像用社区维护的 dko0/lsky-pro。

Docker Compose 部署#

Lsky Pro 本体加一个 MySQL,是最稳妥的组合。数据量小的话安装向导里也可以选 SQLite,那就连数据库容器都省了;但既然要长期当生产图床用,建议一步到位上 MySQL,后续迁移和备份都更规整。

services:
lsky-pro:
image: dko0/lsky-pro:latest
container_name: lsky-pro
restart: unless-stopped
ports:
- "8080:80"
volumes:
- ./lsky-data:/var/www/html
environment:
- MYSQL_HOST=lsky-db
- MYSQL_DATABASE=lsky
- MYSQL_USER=lsky
- MYSQL_PASSWORD=换成你的强密码
depends_on:
- lsky-db
lsky-db:
image: mysql:8.0
container_name: lsky-db
restart: unless-stopped
environment:
- MYSQL_ROOT_PASSWORD=换成你的强密码
- MYSQL_DATABASE=lsky
- MYSQL_USER=lsky
- MYSQL_PASSWORD=换成你的强密码
volumes:
- ./mysql-data:/var/lib/mysql

启动并确认两个容器都正常:

Terminal window
docker compose up -d
docker compose ps
docker compose logs -f lsky-pro

浏览器打开 http://你的IP:8080 进入安装向导:环境检查通过后选 MySQL,数据库地址填容器名 lsky-db(不是 localhost,也不是宿主机 IP),库名、用户名、密码与上面 Compose 里写的保持一致,最后设置管理员账号完成安装。

装完先把入口收好:图床是要对外供图的服务,域名和 HTTPS 按 Nginx Proxy Manager:所有自建服务的统一入口 那篇的套路配上,假设最终地址是 https://img.example.com。后面所有配置都以这个地址为准。

WARNING

图床走反向代理时,如果上传稍大的图片报 413,多半是代理层把请求体拦了。在 NPM 的 Proxy Host 高级设置里补一行 client_max_body_size 20m;(按你后台设的单图上限放大一圈),再检查 Lsky Pro 后台的单图大小限制,两边对齐才不会互相打架。

存储策略:本地盘还是对象存储#

Lsky Pro 的图片实体不绑死在本地,后台「存储策略」里可以建多个策略再分配给不同用户组,支持本地、AWS S3、阿里云 OSS、腾讯云 COS、七牛云、又拍云、FTP/SFTP、WebDAV、MinIO 等。怎么选,看图片的量和你的机器:

维度本地存储S3 兼容对象存储
成本只有 VPS 磁盘按量付费,便宜但有账单
速度取决于 VPS 带宽云厂商带宽+可叠 CDN
扩容受磁盘上限约束几乎无限
备份负担图片文件要自己全量备实体在云端,自己只备数据库
掌控感文件就在手边依赖云厂商账号安全

个人博客量级,一天几张图,本地存储完全够用,简单直接。图片开始以 GB 计、或者 VPS 带宽小得可怜时,再把新策略切到对象存储:S3 兼容接口是通用语,MinIO 自建、Cloudflare R2、以及国内各家云的兼容模式都走这一套,配置项无非是 Endpoint、Bucket、AccessKey、SecretKey 和访问域名这五件套。

两个和图片质量相关的设置顺手在后台配好:

  • 图片压缩:开启上传压缩并给个合理质量(比如 85),截图和照片能省下三到五成体积,肉眼基本看不出差别。
  • 水印:怕图被盗用就开文字或图片水印,设好位置和透明度。注意水印是压在原图上不可逆的,介意留原图的话就关掉,或者只给特定用户组开。

权限与防滥用:图床最怕变成别人的免费仓库#

图床一旦开放游客上传,扫描器和羊毛党几天之内就会找上门:轻则磁盘被垃圾图塞满,重则有人传违法图片,服务器在你名下,出了事第一个被找的是你。所以部署完的第一件事不是美化界面,而是把门关对:

  • 游客上传默认关掉。自己用、家人朋友用,走账号体系足够了;确实要开放,先想清楚审核谁来做。
  • 注册设为关闭或人工审核。在后台把开放注册关掉,需要账号就由管理员手动建,别让任何人自助注册进来传图。
  • 用用户组分层。管理员组不限量,普通组给死配额:单图大小、总容量、每日上传数都设上限,单个账号被滥用时损失可控。
  • 黑名单用起来。后台支持按 IP 和邮箱拉黑,遇到批量灌图的来源直接封段处理。
  • 后台路径和管理员账号独立强密码,再叠加 自建服务安全加固:最小暴露与访问控制 里讲的访问控制,图床的「写入口」只留给该来的人。

原则就一条:图床可以公开读,但写入必须只对自己人开放。读是分享,写是责任,分清楚这两件事,图床就能长期安稳跑下去。

PicGo 对接:写文章时一键上传贴图#

图床装好只是仓库,真正决定日常体验的是上传姿势。手动开网页、选文件、复制链接,一篇文章十张图能把人点烦。PicGo 就是干这个的:截图或复制图片后按快捷键,自动上传并把 Markdown 链接写进剪贴板,回到编辑器粘贴即可。

第一步:给 PicGo 发一张「通行证」#

Lsky Pro 的 API 用 Token 鉴权。用你自己的账号调一次令牌接口即可拿到:

Terminal window
curl -X POST 'https://img.example.com/api/v1/tokens' \
-H 'Content-Type: application/json' \
-d '{"email":"你的邮箱","password":"你的密码"}'

返回的 data.token 形如 1|aBcDeFg...,整段保存好。这个 Token 等于账号的上传钥匙,泄露了别人就能借你的图床传图,只放在自己设备的 PicGo 配置里,别写进任何公开仓库或截图里。

第二步:装插件并配置#

PicGo 本体不带兰空支持,去插件设置里搜索并安装 lankong 插件(也有 lsky-uploader 等同类插件,配置项大同小异),然后在图床设置里找到它,填:

配置项填法
VersionV2(与自建版本对应,选错会直接上传失败)
Serverhttps://img.example.com(只填到域名,不要带多余路径)
Auth token`Bearer 1
策略 ID留空或填 1,即默认存储策略

先在终端验证一下接口本身是通的,再回头查 PicGo 配置,能省很多冤枉路:

Terminal window
curl -X POST 'https://img.example.com/api/v1/upload' \
-H 'Authorization: Bearer 1|aBcDeFg...' \
-H 'Accept: application/json' \
-F 'file=@/path/to/test.png'

返回 JSON 里 data.links.url 是图片直链,还同时给了 markdown 和 html 格式,看到它们就说明服务端没问题。

第三步:接进写作工具#

  • PicGo 桌面端:把兰空设为默认图床,开启「时间戳重命名」避免同名覆盖,上传快捷键记住,流程就是「截图 → 快捷键 → 回文章里粘贴」。
  • Typora:偏好设置 → 图像 → 上传服务选 PicGo.app,写文档时粘贴图片自动走 PicGo 上传,正文里直接落 Markdown 链接。
  • VS Code:装 Lsky 系的上传插件、填同一套 Server 和 Token,在编辑器里一键粘贴图片,适合直接在代码仓库里写文档的人。

完整工作流:从写一篇博客到发一个帖子#

工具齐了,把日常供图流程串起来,其实就四步:

  1. 写:在编辑器里写正文,需要配图时截图或拖入图片,PicGo 自动上传到自建图床,剪贴板里就是 ![](https://img.example.com/...) 格式的链接,粘贴进文章。
  2. 管:图片在 Lsky Pro 后台按相册归档,建议按「博客名/年月」粗分即可,找历史图时能按相册和时间过滤;重复图、废图随手删,别让仓库变垃圾场。
  3. 发:博客发布时文章带着自有域名的图片链接上线;去论坛、社区发帖同理,编辑器支持 Markdown 的直接粘贴,不支持的用图床返回的 HTML 链接或直链插入。
  4. 稳:链接域名是自己的,换博客程序、迁服务器都不影响已发出的图片地址——迁移时只要图床数据跟着走(见下一节),全网旧文的配图一张不裂。

和 Cloudreve:私人云盘部署与存储策略 的分工也说一句:Cloudreve 管的是「文件本身」的存取分享,图床管的是「给文章供图」这一个专门场景,两者别混用——拿网盘分享链接当图床直链用,防盗链和过期策略迟早给你颜色看。

备份:数据库和图片文件,缺一个都不算备份#

图床的数据分两半:一半是 MySQL 里的账号、相册、图片记录和存储策略配置,另一半是图片实体文件(本地策略下在数据目录里,对象存储策略下在云端)。只备份数据库,恢复出来的是满屏裂图;只备份图片文件,恢复出来的是对不上号的散图,两半必须成套走。

本地存储策略下,一次完整的备份就是打包数据目录加导出数据库:

Terminal window
# 导出数据库
docker exec lsky-db mysqldump -u root -p你的密码 lsky > lsky-$(date +%F).sql
# 打包图床数据目录(配置与本地图片都在里面)
tar -czf lsky-data-$(date +%F).tar.gz ./lsky-data ./mysql-data

对象存储策略下,图片实体在云端、由云厂商负责冗余,你要备的收窄为数据库导出加图床的配置文件,但云端 Bucket 的版本控制或跨区复制建议打开,别把鸡蛋全放在一个桶里。

备份的节奏、异地副本和恢复演练,按 自建服务备份与迁移实战 里的统一框架执行即可,图床无非是多一个「恢复后随机抽查十张老图能不能打开」的验收动作。

常见问题与排障#

PicGo 上传报 401 或「You must be logged in」。 Token 过期、被撤销,或者插件里没带 Bearer 前缀,再或者 Version 选成了 V1。先用上面的 curl 直调 /api/v1/upload 验证 Token 本身,接口通了再逐项对插件配置。

网页端上传大图报 413。 代理层请求体上限太小。按前文把 NPM 的 client_max_body_size 放大,同时确认 Lsky Pro 后台单图上限和用户组配额没有卡得更小,三处取最小值生效。

安装向导里数据库怎么都连不上。 地址填了 localhost 或宿主机 IP。在容器网络里,数据库要按容器名 lsky-db 访问;再核对库名、用户名、密码与 Compose 环境变量逐字一致。

图片上传成功,但文章里打开是裂图或被浏览器拦截。 多半是地址不一致:站点实际走 HTTPS,但存储策略里配的访问域名还是 HTTP 或内网地址,触发混合内容拦截。把后台站点地址与存储策略的访问域名统一成最终的 HTTPS 域名,再清一次缓存看。

换了存储策略后,老图还在旧策略里找不到。 策略是按图片逐张绑定的,新策略只对新上传生效,老图不会自动迁移。要搬家先在后台确认每张图的归属,别删旧策略的存储端,先迁移校验再收尾。

小结#

  • 第三方图床的风险不在今天传不上去,而在三年后打不开;自建图床把域名和文件都收回自己手里。
  • Lsky Pro 用 Compose 加 MySQL 部署,多存储策略让本地盘和对象存储可以按量切换,压缩与水印在后台一次配好。
  • 安全顺序不能反:先关游客上传、收紧注册、用用户组配额兜底,再谈开放给别人用。
  • PicGo 加 Token 是体验的分水岭:配好之后,供图就是「截图、快捷键、粘贴」三下,博客和发帖共用一条流水线。
  • 备份永远成套:数据库导出加图片文件打包,缺任何一半都恢复不出完整的图床。
Lsky Pro 兰空图床:自建图床与博客配图工作流
https://www.anexns.cloudns.org/posts/selfhost-lsky-pro/
作者
Anexns
发布于
2026-11-15
许可协议
CC BY-NC-SA 4.0