因 Lsky Pro 需要使用 rewrite 重写 url,所以不支持虚拟主机安装。
Lsky Pro 安装全程可视化页面,只需要下载程序解压到 web 站点目录,访问首页会自动跳转到安装页面,根据提示操作即可,具体步骤:
- 下载兰空,上传至 web 运行环境,解压。
- 设置运行目录为 public。
- 配置 Rewrite 规则:
Nginx:
location / { if (!-e $request_filename) { rewrite ^(.*)$ /index.php?s=$1 last; break; } }
Apache:
Apache直接使用.htaccess即可
- 访问首页,未安装自动跳转至安装页面,根据页面提示安装即可。
- 安装完成以后请设置runtime目录 0755 权限,如果你使用本地存储,public 目录也需要设置为 0755 权限
1.6.0 版本开始, 不再支持修改网站运行目录
环境变量
1.6.0 版本以后, 程序根目录新增了一个环节变量文件:
.env
, 该文件里保存了系统的一些配置, 像下面这样:
[app]
debug = false
trace = false
[database]
hostname = 127.0.0.1
database = lsky
username = root
password = root
hostport = 3306
charset = utf8mb4
prefix = lsky_
[system]
single_user_mode = false
intercept_salacity = false
url_query = ''
配置说明:
app.debug
是否开启 debug 模式, 生产环境请务必关闭
app.trace
是否开启性能分析 Console 插件, 生产环境请务必关闭
database.hostname
数据库连接地址
database.username
数据库名称
database.password
数据库密码
database.hostport
数据库连接端口
database.charset
数据库编码
database.prefix
数据库表前缀
system.single_user_mode
是否开启单用户站点模式, 开启后未登录情况下除了接口只能首页可以访问, 页面展示的是全屏背景图加一个登录按钮, 该背景图可以通过替换public/static/app/images/bg.jpg
文件进行修改
system.intercept_salacity
开启鉴黄后, 上传时检测到违规的图片是否直接拦截
system.url_query
图片链接额外参数(例: ?test=123)
system.watermark
是否开启自动水印功能
储存策略
腾讯云COS
又拍云USS
七牛云KODO
Ftp
基础配置
- 关闭注册:
此功能默认关闭,开启后即关闭注册,注册按钮会呈现不可点击的状态。 - 网站标题:
网站的标题。 - 网站关键字:
网站关键字,利于搜索引擎关键字索引,多个请使用英文逗号分隔。 - 自定义CSS:
使用自定义 css 可以做到覆盖整站的任何标签样式,保存前建议先压缩 css
-统计代码:
可自定义第三方统计代码 - 备案号:
域名备案号,填写后会显示在网站底部。 - 系统公告:
将会在首页显示的公告内容,为空则不显示,支持使用 html 标签
上传配置
- 允许游客上传
是否开启游客上传,此选项默认开启,打开后访客无需登录也可以上传图片。 - 最大上传大小
限制单张上传图片大小,默认5242880(5M),单位:b - 单次同时上传数量
上传每次可选择图片数量 - 允许上传的文件后缀
允许可上传的图片后缀名,逗号隔开,默认为jpg,jpeg,gif,png,ico
(结尾不需要逗号) - 文件路径命名规则
默认为{Y}/{m}/{d}
,生成的路径类似:2018/01/04 - 文件命名规则
默认为{uniqid}
,生成的名称类似:5bb2f89a38935.jpg
用户配置
- 用户初始配额容量
默认为 1073741824(1G),该值修改后,后面注册的用户才会生效。
邮件配置
- 邮件发送方式
默认SMTP,暂时只支持SMTP方式发送邮件。 - SMTP验证方式
可选值:NONE/TLS/SSL,选择了None表示不验证。 - SMTP主机地址
SMTP主机地址,例如126邮箱的smtp服务地址为 smtp.126.com - SMTP用户名
SMTP登录用户名 - SMTP密码
SMTP登录密码 - SMTP端口
SMTP连接端口 - 发件人邮箱
发件人邮箱,填写SMTP登录邮箱
其他配置
- 软删除
此选项默认关闭,开启后,删除图片只删除记录,不删除图片文件。 - 开启API
此选项默认关闭,开启后将会开放站点的API接口,左侧导航栏会出现“接口”入口。 - 封禁IP
封禁IP功能, 多个IP使用英文逗号隔开, 被封禁的IP访问网站会抛出403异常. 支持通配符匹配, 像这样: 127.0.0.* 或者 127.0.*.1, 甚至可以这样: 127.*
注意. 请不要视图 ban 掉自己的 IP, 这样会导致你无法访问网站.
图片鉴黄
图片鉴黄申请地址:https://www.moderatecontent.com
- 开启图片鉴黄
此选项默认关闭,开启后,上传图片会通过鉴黄接口处理,发现黄图将会上传失败。
注意:开启图片鉴黄后会拖慢上传图片速度,接口在墙外的原因,也可能会导致上传失败。 - Key
你申请的图片鉴黄接口Key。 - 内容评级
图片鉴黄分为三个级别,分别为:所有人、少年、成人,默认为成人。- 所有人:最为严格,接口认为图片有一点点涉黄则会上传失败。
- 少年:中等,百分之五十为黄图时会上传失败。
- 成人:百分之九十为黄图时则会上传失败。
- 拦截
从 V1.5.3版本开始,程序 config 文件夹下新增了一个site.php
配置文件,该文件下有个配置项名为intercept_salacity
,将该配置值修改为 true ,上传的图片若被判断为可疑图片则会直接拦截。默认为 false (上传后在可疑图片里)
该配置已经移动至环境变量,请参考环境变量章节
水印功能
1.6.3 版本以后添加了水印功能,默认不开启,需要更改环境变量文件开启,具体参考环境变量章节。
自动水印配置文件:config/watermark.php,文件中有详细的注释说明。
每个储存策略都可以设置独立的水印配置,分为文字水印和图片水印两种类型。
文字水印配置说明:
enable
: 是否启用水印功能
type
: 类型[1=文字水印,2=图片水印]
text
: 水印文字
font
: 字体文件绝对路径
size
: 文件大小
color
: 颜色
locate
: 水印位置[1=左上角,2=上居中,3=右上角,4=左居中,5=居中,6=右居中,7=左下角,8=下居中,9=右下角]
offset
: 文字相对当前位置的偏移量,默认0
angle
: 文字倾斜角度,默认0
图片水印配置说明
enable
: 是否启用水印功能
type
: 类型[1=文字水印,2=图片水印]
source
: 水印图片文件绝对路径
locate
: 水印位置[1=左上角,2=上居中,3=右上角,4=左居中,5=居中,6=右居中,7=左下角,8=下居中,9=右下角]
alpha
: 透明度
FAQ:
- 1.字体、水印图片如何配置?
- 下载你的字体文件或水印图片放置到项目任意目录, 变量 $root 则是项目根目录,即 public 上层目录
- 假如现在有个 test.ttf 字体文件,将它放置到 public 目录下,那么路径则是 $root . 'public/test.ttf'
- 2.文字偏移量(offset)和倾斜角度(angle)支持负数
- 3.每个策略的水印配置,只能同时存在一种类型,不可以同时配置文字水印和图片水印
- 4.启用水印功能后,系统不会保存原图!
系统升级
1.6.0 版本开始, 支持在线升级功能, 1.6.0 以前的版本升级指导请参考该版本根目录下的 README.md 文件.
新版本使用在线升级的方式更新系统, 为了保证跨版本升级的兼容, 每次更新都需要下载完整的安装包.
由于 WEB 服务器环境限制, 脚本执行长时间的任务, 浏览器等待服务器返回数据的时间过长可能会遭到运行环境(Apache 和 Nginx 等)的终止, 不同的运行环境会有不同的差异, 基本都是在 30 秒.
兰空图床更新时会将 PHP 的脚本最大执行时间改为 0, 即永不超时, 但是同样可能会遭到环境的强制终止.
如果在检测更新时出现更新服务器异常, 请稍后重试!,说明你的服务器无法访问到更新服务器。请尝试离线覆盖安装。方法如下:
- 备份原系统
- 下载新版本安装包,解压。将旧版本系统中的根目录
.env
文件复制到新版本的根目录- 如果你的文件是储存在本地,你还需要将
public
目录中的文件移动的新版本的public
目录下
- 如果你的文件是储存在本地,你还需要将
- 修改
.env
文件中的数据库配置,然后在application
目录下新建install.lock
文件 - 将新版本
application/sql/update.sql
导入到数据库,或直接复制文件内容执行 - 替换旧版本 (删除旧版本,粘贴新版本)
如果在更新时出现 更新失败, 请稍后重试 的提示, 大概率是因为超时被中断, 如果出现这样的情况, 请手动通过 https://github.com/wisp-x/lsky-pro/releases 下载 zip 格式的完整包, 并重命名为 upgrade.zip
移动至系统 runtime
目录中, 然后在执行更新, 这时候兰空图床会跳过下载安装包的步骤, 直接通过解压 upgrade.zip
的方式进行安装.
宝塔php7.3版本默认没有开启ZipArchive,更新时会出现错误,切换其他版本即可。
常见问题
迁移服务器后图片上传失败?
请检查新环境中 PHP 是否安装了 fileinfo 拓展,PHP 版本是否大于 5.6,小于 7.4
第三方储存次策略配置后,图片上传失败?
请仔细按照文档中描述的进行配置,通常是因为配置错误,或第三方储存账号没有权限所导致
每一个储存策略中的第一行的域名配置是什么意思?
指的是某用户组使用该储存策略后上传成功得到的链接域名,如果域名不加 http://,系统则会在上传后自动追加 http://,想要得到 https:// 的链接,直接在域名前加上 https:// 即可,不填则会默认使用站点域名
上传文件后提示 upload File size exceeds the maximum value
?
请修改 PHP 的最大上传文件大小限制,如何修改请问度娘
系统设置->基本设置 无法保存?
这是由于服务器开启了防火墙(参数过滤)功能,导致了自定义 css、js (或在系统公告中使用了 html 标签)被拦截造成的错误,要么关闭防火墙,要么清空自定义 css 和 js 后保存
开启鉴黄后图片上传很慢、甚至上传失败?
这是因为图片鉴黄接口的服务器在国外,图片是优先上传到你的服务器,然后鉴黄服务器通过你的图片链接进行抓取图片,你的服务器如果是在中国大陆,就会造成上传很慢的现象。事实上只要开启了鉴黄就会多出一个两个服务器进行通信的步骤,会增加图片上传的时间。
FTP 功能无法上传?
第一步请先确定 PHP 是否开启了 FTP 拓展,然后确保你的 FTP 是能通过外网连接的,可以先使用 FTP 软件进行测试是否连接成功。
安装时出现重定向次数过多
重新安装的时候, 站点开启了单用户模式, 会造成重定向冲突, 解决方法是暂时关闭单用户模式
在线更新失败?
在线功能可能因为你的服务器无法请求 https://api.lsky.pro 或 Github 导致无法获取最新版本信息或安装包下载失败。若在线更新失败,请参考 系统升级 章节处理。
V1.6.4
Latest
Added
- 一键复制全部链接 (#167)
Changed
- 将所有静态资源放置本地
- 接口增加刷新 token 属性
- 个人中心、后台显示用户注册时间 (#263)
FAQ:
- 为了保证可用性,此次更新主要是为了静态文件放置本地,不再使用第三方静态资源托管服务。
- 如没有特殊情况,这次更新为 1.x 版本最后一个小版本。
兰空图床源码最新版1.64详情安装说明作者提供地址 https://www.kancloud.cn/wispx/lsky-pro
兰空图床源码最新版1.64成品搭建网站预览地址 https://pic.hao363.com/
兰空图床源码最新版1.64项目主页:https://www.lsky.pro
兰空图床源码最新版1.64项目仓库地址:https://github.com/wisp-x/lsky-pro
兰空图床源码最新版1.64本站下载地址 https://hdw.lanzouo.com/iOMeaxua3ja