部署兰空图床 & uPic

slug

2023-030

status

Published

准备

将兰空图床部署到服务器之前，需要做一些检查。

根据官方文档的说明，需要首先确认服务器的 PHP 版本 ≥ 8.0.2，然后要检查 PHP 中拓展是否安装齐全，部分函数有没有被禁用。

兰空图床所需的 PHP 拓展和函数包括了：

BCMath PHP 扩展

Ctype PHP 扩展

DOM PHP 拓展

Fileinfo PHP 扩展

JSON PHP 扩展

Mbstring PHP 扩展

OpenSSL PHP 扩展

PDO PHP 扩展

Tokenizer PHP 扩展

XML PHP 扩展

Imagick 拓展

exec、shell_exec 函数

readlink、symlink 函数

putenv、getenv 函数

数据库方面，您可以选择：

Mysql 5.7+

PostgreSQL 9.6+

SQLite 3.8.8+

SQL Server 2017+

创建网站

在宝塔面板中，新建一个网站。

上传并解压从 GitHub 中下载的版本到网站的文件中（您也可以选择远程下载-从 URL 下载）。

1. 将程序所在目录的所有文件夹、子文件夹、文件的权限，用户组和所有者改为 www，权限改为 0755

⚠️

若未正确设置权限，在后续的使用过程中可能会因为权限导致文件无法读取、无法写入、创建文件夹等一系列问题。

将站点的运行目录指向程序的 public 文件夹。

设置伪静态

在浏览器输入您创建的网站地址，完成后续安装。

图床配置

安装完成后，输入您在上述第六步中设置的邮箱和密码登录管理界面。

我建议在系统设置中将注册和游客上传关掉，以避免您的图床被滥用，给您造成负面影响。

在储存策略中，您可以设置图片存储的位置。兰空图床支持本地存储，AWS S3，阿里云 OSS，腾讯云 COS，七牛云 Kodo，又拍云 USS，SFTP，FTP，WebDAV，Minio 等十种存储位置。

如图所示，我就添加了腾讯云对象存储作为图片的默认存储位置。

uPic 设置

uPic 是一款 macOS 中的图床工具，可以帮助我们快速上传图片到图床。要在 uPic 配置兰空图床，需要获取兰空图床的 token。

我们可以到服务器的 SSH 中通过 curl 命令一键获取。

然后到 uPic 的偏好设置中选择图床-自定义。

API 地址是 your.domain/api/v1/upload

请求方式为 POST

文件字段名为 file

URL 路径为 ["data", "links", "url"]

保存路径为 {year}/{month}/{day}/{filename}{suffix}

然后点击其他字段，增加 Header 字段。

Content-Type：multipart/form-data

Accept：application/json

Authorization：Bearer + token，例如 Bearer 1|2zxF05em0J2UcFxxxxxxxxxxxxxx

⚠️

注意 Bearer 和 token 中间有一个空格。

全部配置完成后点击验证，此时图床上出现了一张图片，表明配置成功。