Lsky Pro 自建图床全流程指南

写博客离不开图床。之前用微博相册、SM.MS,后来全迁到自建的 Lsky Pro。免费、开源、Docker 部署,图片自己管。

为什么自建图床

- 免费 — 不用买图床服务

- 可控 — 图片存在自己服务器

- CDN — 配合 Cloudflare 加速全国访问

- API — 支持 PicGo、Typora 直接上传

部署

version: "3.8"

services:

lsky-pro:

image: lsky-org/lsky-pro:latest

container_name: lsky-pro

restart: unless-stopped

ports:

- "40027:80"

volumes:

- ./lsky-data:/var/www/html

environment:

- APP_URL=http://img.soulwrite.xyz

- DB_HOST=mysql

- DB_PORT=3306

- DB_DATABASE=lsky

- DB_USERNAME=lsky_user

- DB_PASSWORD=lsky_pass

depends_on:

- mysql

networks:

- app

mysql:

image: mysql:8.0

container_name: lsky-mysql

restart: unless-stopped

environment:

- MYSQL_DATABASE=lsky

- MYSQL_USER=lsky_user

- MYSQL_PASSWORD=lsky_pass

- MYSQL_ROOT_PASSWORD=root密码

volumes:

- ./mysql-data:/var/lib/mysql

networks:

- app

networks:

app:

driver: bridge

首次访问 http://IP:40027 填写管理员信息。

配置存储

后台 → 设置 → 存储:

本地存储(默认)

默认存在 /var/www/html/storage,已通过 volume 映射到 ./lsky-data

阿里云 OSS

- 驱动:阿里云 OSS

- Bucket、AccessKey、SecretKey 填进去

- 域名用你自己的 OSS 域名

Cloudflare R2

免费 10GB,适合做 CDN 回源:

- 驱动:AWS S3

- 端点:R2 提供的 endpoint

- 区域:auto

对接 PicGo(推荐)

PicGo 是 Windows/Mac 图床上传工具,配合 Lsky Pro 非常好用。

安装 PicGo

官网下载安装:https://github.com/Molunerfinn/PicGo

配置 Lsky Pro

1. 后台 → 设置 → API → 开启 API

2. 生成 Token

PicGo 配置

- 插件:lsky-pro

- URL:http://img.soulwrite.xyz

- Token:刚才生成的

现在截图 → Ctrl+V → 自动上传,返回 Markdown 链接。

域名 + HTTPS

OpenResty 反代:

upstream lsky_backend {

server lsky-pro:80;

}

server {

listen 443 ssl;

server_name img.soulwrite.xyz;

ssl_certificate /path/to/cert.pem;

ssl_certificate_key /path/to/key.pem;

location / {

proxy_pass http://lsky_backend;

proxy_set_header Host $host;

proxy_set_header X-Real-IP $remote_addr;

}

}

踩坑记录

坑 1:图片上传 413

反代没配 client_max_body_size

client_max_body_size 50M;

坑 2:Token 无效

Lsky Pro 的 Token 会过期。每次重启容器可能变。改成「允许游客上传」更省心:

后台 → 游客权限 → 允许上传

坑 3:图片不显示

Lsky Pro 的图片需要正确的 URL。后台 → 设置 → 站点 URL 一定要填对:

https://img.soulwrite.xyz

我怎么用

1. Typora — 写博客时截图直接粘,PicGo 自动上传

2. VS Code — 用 vscode-picgo 插件

3. 微信 — 偶尔手动传一下

总结

Lsky Pro 是最值得自建的服务之一:

- 免费开源 — 不花钱

- Docker 部署 — 几分钟搞定

- 生态完善 — PicGo、Typora 都支持

- 存储灵活 — 本地/OSS/R2 都行

一张图片几分钱的服务费看起来不多,但长期写博客下来也是一笔开销。自己搭,一次投入永久免费。