LskyPro 搭建教程 – 搭建你自己的图片托管服务

一、兰空图床是什么

兰空图床（Lsky Pro）是一个开源的图片托管程序。你可以把它部署在自己的服务器上，然后通过网页上传图片，获得图片的直链地址。这个直链可以用于博客、论坛、Markdown 文档、社交媒体等任何需要插入图片的地方。

它和我们之前搭建的 Alist 不同：Alist 是文件列表和管理工具，兰空图床则专注于图片的上传、存储和直链生成。它支持多种存储策略——你可以把图片存在本地服务器硬盘上，也可以存到阿里云 OSS、腾讯云 COS、七牛云、又拍云、AWS S3、FTP 等远程存储中。

兰空图床的典型用途：

• 写博客时需要插入图片，不用再依赖微博图床或其他第三方服务（那些随时可能挂掉）。
• Markdown 写作，配合 PicGo 等上传工具，截图自动上传并返回 Markdown 格式的链接。
• 团队共享图片素材，搭建内部使用的图片库。
• API 对接，其他程序可以通过 API 上传和管理图片。

兰空图床完全开源免费，GitHub 仓库：https://github.com/lsky-org/lsky-pro

二、你需要准备什么

准备项	说明	是否必须
一台电脑或云服务器	Windows/Linux 均可。长期使用推荐云服务器（最低 1 核 1G）	✅ 必须
PHP 环境（8.0 以上）	兰空图床基于 PHP 开发，需要 PHP 运行环境	✅ 必须
MySQL 数据库	5.7 或 8.0 版本	✅ 必须
Nginx 或 Apache	Web 服务器，用于接收 HTTP 请求	✅ 必须
一个域名（可选）	如果没有域名，用 IP 地址也可以访问	❌ 可选

如果你不想手动配置 PHP + Nginx + MySQL 这套环境，可以直接使用宝塔面板（一个可视化的服务器管理工具）来一键安装环境，或者使用 Docker 部署。这两种方式本教程都会覆盖。

三、部署方式一：宝塔面板部署（最简单，适合新手）

宝塔面板是一个可视化的 Linux 服务器管理工具。你不需要记 Linux 命令，在网页上点一点就能安装 PHP、MySQL、Nginx，然后一键部署兰空图床。

3.1 安装宝塔面板

连接到你的云服务器（用 FinalShell 或终端），执行以下命令：

# Ubuntu / Debian 系统
wget -O install.sh https://download.bt.cn/install/install-ubuntu_6.0.sh && sudo bash install.sh

# CentOS 系统
yum install -y wget && wget -O install.sh https://download.bt.cn/install/install_6.0.sh && sh install.sh

安装过程中会询问你是否同意安装到某个目录，输入 y 然后回车。等待几分钟，安装完成后终端会显示：

宝塔面板安装成功！
外网面板地址：http://你的IP:8888/xxxxxxxx
内网面板地址：http://127.0.0.1:8888/xxxxxxxx
username: xxxxxxxx
password: xxxxxxxx

记下外网面板地址、用户名和密码。

3.2 安装 LNMP 环境

1. 浏览器访问宝塔面板的外网地址，用提供的用户名密码登录。
2. 首次登录会弹出一个“推荐安装套件”窗口。选择 LNMP（Linux + Nginx + MySQL + PHP）。
3. 在版本选择中：
   • Nginx：选择最新稳定版即可。
   • MySQL：选择 5.7 或 8.0。
   • PHP：必须选择 8.0 或以上版本（兰空图床要求 PHP ≥ 8.0）。
4. 选择“极速安装”（编译安装太慢，初学者不需要）。
5. 点击“一键安装”，等待安装完成。这个过程可能需要 10-30 分钟。

3.3 创建网站和数据库

环境安装完成后，开始部署兰空图床。

第一步：创建数据库

1. 在宝塔面板左侧菜单中，点击 数据库。
2. 点击 添加数据库。
3. 填写：
   • 数据库名：lsky（可以自定义）
   • 用户名：lsky（可以自定义）
   • 密码：设置一个复杂的密码，记下来，后面要用。
4. 点击提交。

第二步：创建网站

1. 在宝塔面板左侧菜单中，点击 网站。
2. 点击 添加站点。
3. 填写：
   • 域名：如果你有域名，填写你的域名（如 img.yourdomain.com）。如果没有域名，填写你的服务器公网 IP 地址。
   • 根目录：会自动生成，保持不变即可。
   • PHP 版本：选择你刚才安装的 PHP 8.0 或以上版本。
4. 点击提交。

第三步：下载兰空图床源码

1. 打开浏览器新标签页，访问 https://github.com/lsky-org/lsky-pro/releases
2. 在最新版本中，下载 lsky-pro-x.x.x.zip 文件。
3. 回到宝塔面板 → 文件 菜单。
4. 在左侧目录树中，找到你刚才创建的网站根目录（通常在 /www/wwwroot/你的域名或IP）。
5. 进入这个目录，删除里面的所有默认文件（通常有 .htaccess 和 index.html）。
6. 点击 上传 按钮，选择刚才下载的 ZIP 文件。
7. 上传完成后，右键 ZIP 文件 → 解压。
8. 如果解压出来的文件在一个子文件夹里，把这些文件移动到网站根目录（不要放在子文件夹里）。

第四步：设置运行目录和伪静态

1. 在宝塔面板 → 网站，点击你创建的网站域名。
2. 在左侧点击 网站目录。
3. 运行目录 选择 /public，点击保存。
4. 在左侧点击 伪静态。
5. 选择 laravel5（兰空图床基于 Laravel 框架），点击保存。

第五步：安装兰空图床

1. 浏览器访问你的域名或 IP 地址（如 http://你的IP）。
2. 你会看到兰空图床的安装向导页面。
3. 点击“下一步”，系统会检查环境是否满足要求。确保所有项都是绿色的勾。
4. 填写数据库信息：
   • 数据库主机：127.0.0.1
   • 数据库端口：3306
   • 数据库名称：lsky（你在宝塔中创建的数据库名）
   • 数据库用户名：lsky
   • 数据库密码：你设置的密码
5. 点击“下一步”，设置管理员账号：
   • 管理员邮箱：填写你的邮箱
   • 管理员密码：设置一个密码
6. 点击“安装”，等待几秒钟。
7. 安装成功！点击“进入系统”，用刚才设置的管理员邮箱和密码登录。

至此，兰空图床搭建完成。登录后台后，你就可以上传图片、创建相册、管理存储策略了。

四、部署方式二：Docker 部署

如果你不想装宝塔面板，也可以用 Docker 快速部署。

4.1 确保 Docker 和 Docker Compose 已安装

# 检查 Docker
docker --version

# 检查 Docker Compose
docker compose version

4.2 创建项目目录和配置文件

# 创建目录
mkdir -p ~/lsky-pro && cd ~/lsky-pro

# 创建 docker-compose.yml 文件
cat > docker-compose.yml << 'EOF'
version: '3'
services:
  lsky:
    image: halcyonazure/lsky-pro:latest
    container_name: lsky-pro
    restart: unless-stopped
    ports:
      - "8080:80"
    volumes:
      - ./data:/var/www/html
    environment:
      - WEB_PORT=80
EOF

4.3 启动容器

docker compose up -d

4.4 访问安装向导

浏览器访问 http://你的IP:8080，进入安装向导。数据库可以使用 SQLite（容器内置，无需额外安装 MySQL）或连接外部 MySQL。

• 使用 SQLite：在安装向导中，数据库类型选择 SQLite，路径填写 /var/www/html/database.sqlite。
• 使用 MySQL：需要另外部署 MySQL 容器或在 docker-compose 中增加 MySQL 服务。

五、部署方式三：手动部署（Linux + Nginx + PHP + MySQL）

如果你不使用宝塔面板也不用 Docker，可以手动搭建环境。

5.1 安装 Nginx、PHP 8.0+、MySQL

# Ubuntu 系统
sudo apt update
sudo apt install -y nginx mysql-server

# 添加 PHP 源并安装 PHP 8.2
sudo apt install -y software-properties-common
sudo add-apt-repository ppa:ondrej/php -y
sudo apt update
sudo apt install -y php8.2 php8.2-fpm php8.2-mysql php8.2-mbstring php8.2-xml php8.2-gd php8.2-curl php8.2-zip php8.2-bcmath

# 启动服务
sudo systemctl start nginx mysql php8.2-fpm
sudo systemctl enable nginx mysql php8.2-fpm

5.2 创建数据库

sudo mysql

# 在 MySQL 命令行中执行
CREATE DATABASE lsky CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'lsky'@'localhost' IDENTIFIED BY '你的密码';
GRANT ALL PRIVILEGES ON lsky.* TO 'lsky'@'localhost';
FLUSH PRIVILEGES;
EXIT;

5.3 下载兰空图床源码

cd /var/www
sudo git clone https://github.com/lsky-org/lsky-pro.git
cd lsky-pro
sudo chown -R www-data:www-data .
sudo chmod -R 755 storage public

5.4 配置 Nginx

sudo nano /etc/nginx/sites-available/lsky

粘贴以下内容（把 你的域名或IP 替换为实际值）：

server {
    listen 80;
    server_name 你的域名或IP;
    root /var/www/lsky-pro/public;

    index index.php index.html;

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

    location ~ \.php$ {
        fastcgi_pass unix:/var/run/php/php8.2-fpm.sock;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
    }

    location ~ /\.(?!well-known).* {
        deny all;
    }
}

# 启用站点
sudo ln -s /etc/nginx/sites-available/lsky /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl reload nginx

5.5 访问安装向导

浏览器访问 http://你的IP，按向导完成安装。

六、基本配置和使用

6.1 创建存储策略

登录兰空图床后台后，需要先配置图片存到哪里：

1. 左侧菜单 → 存储策略 → 新增存储策略。
2. 选择存储类型：
   • 本地存储：图片存在服务器硬盘上。
   • 阿里云 OSS / 腾讯云 COS / 七牛云 / 又拍云 / AWS S3：图片存在云端对象存储中，访问更快、更稳定。
3. 填写对应的配置信息（如 AccessKey、SecretKey、Bucket 名称等），点击保存。

6.2 上传图片

1. 左侧菜单 → 图片管理 → 点击 上传图片。
2. 选择图片文件（支持拖拽上传），选择存储策略和相册。
3. 上传完成后，图片下方会显示直链地址。复制这个地址，就可以在任何地方引用这张图片。

6.3 配合 PicGo 使用（截图自动上传）

兰空图床支持 PicGo 插件，可以实现在电脑上截图后自动上传到图床，并返回 Markdown 或直链格式。

1. 在兰空图床后台 → 系统设置 → API 接口，生成一个 API Token。
2. 下载 PicGo，安装 lsky-pro 插件。
3. 在 PicGo 插件配置中填写你的兰空图床地址和 API Token。
4. 之后截图自动上传，链接自动复制到剪贴板。

七、常见问题

Q1：安装时提示“PHP 版本过低”

兰空图床要求 PHP ≥ 8.0。检查你的 PHP 版本：php -v。如果低于 8.0，需要升级 PHP 或更换部署方式。

Q2：上传图片失败，提示“没有写入权限”

这是文件权限问题。执行以下命令：

sudo chown -R www-data:www-data /var/www/lsky-pro
sudo chmod -R 755 /var/www/lsky-pro/storage /var/www/lsky-pro/public

Q3：安装后访问首页空白或 500 错误

通常是因为 伪静态（URL 重写）没有配置。在 Nginx 配置中确保有 try_files $uri $uri/ /index.php?$query_string; 这一行。如果是宝塔部署的，确保在“伪静态”中选择了 laravel5。

Q4：如何升级兰空图床到最新版

• 宝塔部署：下载最新 ZIP，解压覆盖旧文件（保留 .env 配置文件和 storage 目录）。
• Docker 部署：docker compose pull && docker compose up -d
• 手动部署：cd /var/www/lsky-pro && sudo git pull

八、总结

兰空图床是一个非常成熟的开源图片托管程序。部署流程总结：

1. 准备环境：PHP 8.0+、MySQL、Nginx（宝塔/Docker/手动）。
2. 下载源码：从 GitHub Releases 下载最新版本。
3. 配置网站：设置运行目录为 /public，配置伪静态（laravel5）。
4. 安装向导：浏览器访问，填写数据库信息和管理员账号。
5. 配置存储策略：选择图片存放位置（本地或云存储）。
6. 上传使用：通过网页上传或配合 PicGo 自动上传。

项目地址：https://github.com/lsky-org/lsky-pro