跳到主要内容

常见问题

如何使用 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 等依赖。因此并不能通过上述步骤将系统还原到安装脚本之前的状态。