常见问题

如何使用 FTP?#

如果你在安装过程中默认选择了 FTP,那么你将可以通过 5757 端口访问 FTP,强烈建议使用带有 TLS 加密的 FTP。

为什么会安装失败?#

尽管已经做过很多测试,但是 QuickBox Lite 脚本仍然无法保证每次都能成功安装,在遇到安装失败的情况时,请检查如下内容:

  1. 系统版本:请务必注意使用的操作系统版本,仅支持 Debian 9/10, Ubuntu 16.04/18.04/20.04 五个版本的 x64 系统。
  2. 软件源:有些系统自带的软件源并不是最新的,部分链接甚至可能会失效,请务必在安装过程中替换源。
  3. 网络:特别是亚太用户,往往会遇到一些网络超时导致的下载错误,因此可以尝试使用代理。
  4. dpkg lock:部分时候会遇到 dpkg 包管理器锁定,那么请重启系统,通常可以解决问题。
  5. 其他错误情况:如果出现重装系统,并且没有出现上述问题的时候,请提供 /root/quickbox.$PID.log 安装日志用以分析问题。

为什么应用安装会出错?#

有一些时候你会遇到应用安装失败,可能遇到的形式以及解决方法如下:

  1. 面板上点击安装时,弹出的日志窗口很长时间没有任何输出。对于这种情况,一般是 dpkg lock 问题,或者是系统高负载,无法及时反应信息。解决方法:通过 SSH 连接,输入 box fix dpkg 以删除 lock ,然后尝试再次安装。
  2. 显示安装完成后,页面链接跳转出现 404。该情况一般是 nginx 配置出现问题,通过卸载软件再安装通常可以解决。
  3. 显示安装完成后,页面链接跳转出现 502。该情况通常是软件 WebUI 服务没有正常工作,请检查服务控制台中的服务是否启动,若已启动,则尝试 Ctrl + F5 清除浏览器缓存再访问,若未启动则参见方法4
  4. 显示安装完成后,页面链接跳转出现 502,服务控制台也显示服务未启动。这通常是因为软件没有正常安装造成,请尝试卸载并再次安装。该情况常见于国内的本地安装,因为一些网络状况波动造成软件无法被正常下载,可以通过为系统配置代理并且在命令行运行 box install APP NAME 来解决。个别时候是软件本身下载链接出现问题,那么基本上只能改天再试。
  5. 其他情况:如果上述方法均不能解决问题,请在 SSH 中运行 box install APP NAME 并且将最终得到的 /srv/dashboard/db/output.log 提交给我用以分析。

在哪里可以找到安装日志?#

QuickBox Lite 将默认的应用安装日志存储于 /srv/dashboard/db/output.log 文件中,你可以在新建的 SSH 会话中使用 tail -f /srv/dashboard/db/output.log 来获取安装的实时输出信息。

将来是否会提供 xxx 软件?#

你可以通过提交 Issue 或者 Pull Request 来请求支持,我不能保证完成的时间,也不能保证实现这些功能。

是否提供 docker 版本?#

目前不可用,未来也暂且没有计划。

如何卸载 quickbox-lite?#

如同目前大部分的 Seedbox script,quickbox-lite 脚本也没有设计卸载功能。通常来说建议重新安装系统,但你仍然可以用手动方式移除 quickbox-lite 的主要组件。

  • 如果你不需要使用已经安装好的软件,可以直接使用 box remove 命令逐个删除
  • quickbox-lite 的面板 /srv
  • quickbox-lite 的脚本 /etc/QuiciBox , /usr/local/bin/quickbox
  • quickbox-lite 使用的 lock file /install
  • bash 环境 /root/.bash_qb
  • 账户信息 /root/.quickbox
  • Nginx 配置文件 /etc/nginx/apps, /etc/nginx/conf.d
注意

由于 quickbox-lite 使用的软件包也会产生各种配置文件,并且会安装 nginx/php 等依赖。因此并不能通过上述步骤将系统还原到安装脚本之前的状态。