绿联NAS部署Lsky Pro(兰空图床)的完整教程
Lsky Pro(兰空图床)的部署很简单,最推荐的方式是通过绿联NAS自带的 Docker 管理器来完成。我整理了两种主流的安装方案,你可以根据自己的技术偏好和数据库情况来选择。方案一是更适合新手的详细图形化界面指南,方案二则适合熟悉 docker-compose.yml 文件的用户。
🐳 方案一:Docker图形界面手动部署 (推荐新手)
这种方式完全通过绿联NAS的图形化界面操作,步骤非常直观。
准备工作(在主容器上花一分钟准备即可):
在开始之前,先在NAS的文件管理器里为即将运行的两个程序(Lsky Pro 和 MySQL数据库)准备好数据存放目录。
- 打开NAS的 文件管理器。
- 进入
Docker文件夹(如果不存在请新建一个)。 - 在
Docker文件夹下,分别新建lsky-pro和mysql两个文件夹。 - 记住你的NAS IP地址(例如:
192.168.x.x),安装时会用到。
第一步:部署Lsky Pro主程序
- 打开 Docker管理器,进入 镜像管理 → 镜像仓库,搜索
halcyonazure/lsky-pro-docker,选择latest版本下载。 - 下载完成后,在 本地镜像 中找到它,点击 创建容器。
- 基础设置:给容器命个名,比如
lsky-pro。重启策略推荐设为 “容器退出时总是重启容器”,确保NAS重启后图床能自动运行。 存储空间:这里需要将NAS上的文件夹映射到容器里。
- 点击“添加”。
- 装载路径:填入
/var/www/html(这是容器内部的固定路径)。 - 绑定路径:选择你在“准备工作”中创建的
/Docker/lsky-pro文件夹。 - 类型:务必设置为
读写。
端口设置:告诉NAS怎么“找到”这个容器。
- 删除任何已有的
80端口。 再添加一条记录:
- 容器端口:填入
8089(容器内部服务端口,固定不变)。 - 本地端口:填入一个计划用于访问图床的端口,例如
8089或其他不冲突的端口。
- 容器端口:填入
- 删除任何已有的
- 点击 下一步 -> 完成。此时,请 暂时不要启动这个容器,我们先去设置数据库。
第二步:部署MySQL数据库 (为Lsky Pro提供数据支持)
Lsky Pro需要数据库来存储信息,我们以MySQL为例。
- 回到 镜像仓库,搜索
mysql,选择5.7版本并下载。 - 在 本地镜像 中找到它,点击 创建容器。
- 基础设置:命名容器(如
mysql-lsky),并同样设置重启策略为 “容器退出时总是重启容器”。 - 网络:选择 host 模式,这会让数据库和NAS网络互通,配置起来更简单。
存储空间:配置数据存储目录,确保数据不会因容器更新而丢失。
- 点击“添加”。
- 装载路径:填入
/var/lib/mysql。 - 绑定路径:选择
/Docker/mysql文件夹。 - 类型:
读写。
环境:这是关键一步,必须设置MySQL的root密码。
- 环境变量:添加
MYSQL_ROOT_PASSWORD = 你的密码(请务必把这串密码记下来,后面会用到)。
- 环境变量:添加
- 点击 下一步 -> 完成。确保MySQL容器正在运行。
第三步:创建Lsky Pro专用的数据库
- 打开电脑的命令行工具,通过SSH连接到你的NAS(Windows使用PuTTY或PowerShell,Mac使用终端):
ssh 你的NAS用户名@你的NAS IP地址。 - 登录后,输入以下命令进入MySQL容器:
docker exec -it mysql-lsky mysql -uroot -p - 输入你在第二步第6点设置的密码,登录到MySQL命令行。
- 输入以下命令创建一个名为
lsky的数据库:CREATE DATABASE lsky; - 可以输入
exit退出数据库,再输入exit退出NAS的SSH连接。
第四步:启动并装Lsky Pro图床系统
前面的辛苦准备都是为了这一步!
- 回到 Docker → 容器管理,找到之前创建但未启动的
lsky-pro容器,点击 启动。 - 容器启动后,在浏览器地址栏输入
http://你的NAS IP地址:你设置的本地端口(比如:http://192.168.1.100:8089),打开Lsky Pro的欢迎页。 - 环境检测:页面会自动检测环境。如果所有项目都显示绿色“正常”或“支持”,直接点击 下一步。
数据库配置:根据提示填写连接信息。
- 数据库类型:选择
MySQL。 - 数据库地址/主机:填写
127.0.0.1(因为MySQL用了host网络模式,且与Lsky Pro同在NAS中,所以可以用这个地址连接)。 - 端口:保持
3306默认即可。 - 数据库名/用户名/密码:
lsky/lsky/自己设置的密码。 - 管理员邮箱/密码:设置你登录图床后台的管理员账号。
- 数据库类型:选择
- 点击“下一步”或“安装”,稍等片刻即可完成。如果这个页面报超时,尝试刷新一下。
🐳 方案二:Docker Compose一键部署 (适合进阶玩家)
如果你熟悉 docker-compose.yml 文件,或者想体验更自动化的部署,可以用“项目”功能一键部署整个环境,包括应用和数据库。
- 在绿联NAS的 Docker管理器 中,找到 项目 (或类似Compose功能) 选项。
- 点击 创建。给它起个名字,比如
lskypro,并把下面的代码粘贴到Compose配置框里。
services:
mariadb:
image: linuxserver/mariadb:latest
container_name: lskypro-db
environment:
- MYSQL_DATABASE=lskypro
- MYSQL_ROOT_PASSWORD=你的数据库密码
- MYSQL_USER=lskypro_user
- MYSQL_PASSWORD=你的用户密码
volumes:
- /你的路径/docker/lskypro/db:/config
restart: unless-stopped
lskypro:
image: wbsu2003/lskypro:latest
container_name: lskypro-app
ports:
- 你设置的访问端口:80
volumes:
- /你的路径/docker/lskypro/html:/var/www/html
restart: always
depends_on:
- mariadb- 把代码中的
/你的路径/docker/lskypro/db和/你的路径/docker/lskypro/html改成你准备存放数据的位置。数据库密码也记得修改一下。 - 点击 部署,等待Docker自动拉取镜像并启动所有容器。
- 部署成功后,访问
http://你的NAS IP地址:你设置的访问端口进行初始化。 - 在初始化界面的数据库连接部分,填入
lskypro-db作为数据库地址,数据库名和密码就用上面environment部分您自己设置的那些。
🛡️ 重要安全提示:保护你的图床
安装完成后,为防止随意使用和滥用,请务必进入后台进行以下安全设置:
- 关闭注册功能:在 系统设置 → 注册与登录 中,关闭“允许新用户注册”,防止陌生人使用你的图床。
- 管理游客权限:在 系统设置 → 上传设置 中,建议关闭“允许游客上传”,避免网站成为公共垃圾桶。
- 调整图片上传限制:在 系统设置 里,根据你的网络使用情况,适当调高“最大上传大小”,比如10MB、20MB,以满足日常需求。
❓ 常见问题
无法访问图床网页?
- 检查Docker容器
lsky-pro是否正常运行。 - 确认访问地址的IP和端口号是否正确。
- 检查NAS的防火墙设置,确保本地端口已放行。
- 检查Docker容器
数据库连接失败?
- 确认数据库容器运行中,并创建了你所填写的同名数据库。
- 检查你在配置页面填写的数据库主机地址、端口和密码是否正确。
- 如果使用方案一,数据库地址是
127.0.0.1;如果使用方案二 (Compose),数据库地址是服务名mariadb。
图片上传后URL无法显示?
- 进入后台 → 存储策略 → 编辑你的存储策略,在“访问地址”一项中,填写完整的图床访问地址,例如
http://你的NAS IP:端口。
- 进入后台 → 存储策略 → 编辑你的存储策略,在“访问地址”一项中,填写完整的图床访问地址,例如
🔗 扩展应用:搭配PicGo使用
为了更高效地上传图片,你可以将Lsky Pro与桌面端图床工具 PicGo 搭配使用:
- 在PicGo中,进入 插件设置,搜索并安装
lskypro插件。 - 在PicGo的图床设置中,找到Lsky Pro,填入你的图床访问域名和API密钥(在Lsky Pro后台的“API接口”获取)。