先说问题:文章里的图片,凭什么寄人篱下
写博客、发帖子都绕不开配图。最省事的做法是把图片传到第三方图床,或者干脆引用别家网站的图片链接。省事的代价是:你的文章寿命,被别人的服务器决定了。
这类教训这些年一再重演:
- 免费图床说关就关。运营方成本撑不住、政策变了、域名到期了,图片一夜之间全部变裂图,文章还躺在那里,配图已经没了。
- 大厂图床搞防盗链。某社交平台的图片外链先是加 Referer 校验,后来直接 403,几年间无数博客的配图集体失效,只能一篇篇回头修。
- 引用别人站点的图片更不可控。对方改版、删图、换域名,你的文章就跟着遭殃,而且你连通知都不会收到。
图床这件事的本质是:图片文件不大、流量不高,完全在个人 VPS 的能力范围内,没必要把命门交出去。自建图床的核心价值就一句话:链接永远长在自己的域名上,文件永远躺在自己的磁盘里。
本篇主线:Compose 部署 Lsky Pro → 配存储策略 → 关好权限防滥用 → PicGo 对接实现一键上传 → 串起博客与发帖的供图工作流 → 把数据备好。
选型:为什么是 Lsky Pro
自建图床的常见选择,先拉个表对齐一下:
| 方案 | 数据库 | 存储后端 | 权限/用户组 | API 上传 | 适合场景 |
|---|---|---|---|---|---|
| Lsky Pro(兰空) | MySQL / SQLite | 本地、S3、OSS、COS、WebDAV 等多种 | 有,多用户组配额 | 有,Token 鉴权 | 个人到小团队的正经图床 |
| EasyImage | 无 | 仅本地 | 弱 | 有 | 极简自用,不想维护数据库 |
| Chevereto | MySQL | 本地、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启动并确认两个容器都正常:
docker compose up -ddocker compose psdocker 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 鉴权。用你自己的账号调一次令牌接口即可拿到:
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 等同类插件,配置项大同小异),然后在图床设置里找到它,填:
| 配置项 | 填法 |
|---|---|
| Version | V2(与自建版本对应,选错会直接上传失败) |
| Server | https://img.example.com(只填到域名,不要带多余路径) |
| Auth token | `Bearer 1 |
| 策略 ID | 留空或填 1,即默认存储策略 |
先在终端验证一下接口本身是通的,再回头查 PicGo 配置,能省很多冤枉路:
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,在编辑器里一键粘贴图片,适合直接在代码仓库里写文档的人。
完整工作流:从写一篇博客到发一个帖子
工具齐了,把日常供图流程串起来,其实就四步:
- 写:在编辑器里写正文,需要配图时截图或拖入图片,PicGo 自动上传到自建图床,剪贴板里就是
格式的链接,粘贴进文章。 - 管:图片在 Lsky Pro 后台按相册归档,建议按「博客名/年月」粗分即可,找历史图时能按相册和时间过滤;重复图、废图随手删,别让仓库变垃圾场。
- 发:博客发布时文章带着自有域名的图片链接上线;去论坛、社区发帖同理,编辑器支持 Markdown 的直接粘贴,不支持的用图床返回的 HTML 链接或直链插入。
- 稳:链接域名是自己的,换博客程序、迁服务器都不影响已发出的图片地址——迁移时只要图床数据跟着走(见下一节),全网旧文的配图一张不裂。
和 Cloudreve:私人云盘部署与存储策略 的分工也说一句:Cloudreve 管的是「文件本身」的存取分享,图床管的是「给文章供图」这一个专门场景,两者别混用——拿网盘分享链接当图床直链用,防盗链和过期策略迟早给你颜色看。
备份:数据库和图片文件,缺一个都不算备份
图床的数据分两半:一半是 MySQL 里的账号、相册、图片记录和存储策略配置,另一半是图片实体文件(本地策略下在数据目录里,对象存储策略下在云端)。只备份数据库,恢复出来的是满屏裂图;只备份图片文件,恢复出来的是对不上号的散图,两半必须成套走。
本地存储策略下,一次完整的备份就是打包数据目录加导出数据库:
# 导出数据库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 是体验的分水岭:配好之后,供图就是「截图、快捷键、粘贴」三下,博客和发帖共用一条流水线。
- 备份永远成套:数据库导出加图片文件打包,缺任何一半都恢复不出完整的图床。