FOSSBilling 安装

先决条件

  • 专用于FOSSBilling的域名或子域名(子文件夹目前不适用)。
  • 您的服务器必须满足或超过系统要求。
  • 运行为FOSSBilling创建的配置的网络服务器(请参阅下面的示例)。

Webserver 配置

除Apache外,以下配置应作为示例使用,并作为安装FOSSBilling的起点。他们可能有需要更换的占位符,或者在某种程度上是不完整的。

如果您使用的是自己没有设置的服务器/控制面板,并且您不确定正在使用哪种类型的网络服务器,那么最有可能的是Apache,这将是最容易设置的。

如果您不确定如何执行所选网络服务器的基本设置(例如配置虚拟主机),我们建议您在谷歌上搜索您遇到的问题。Digital Ocean等公司有一些高质量的指南,可以比我们更好地描述基本流程。

好消息!FOSSBilling 包含正确的.htaccess开箱即用文件。像往常一样设置域,然后继续安装步骤。如果您使用的是OpenLiteSpeed,请务必在安装后重新加载相关服务,以便服务器加载新的.htaccess文件。

 

预安装步骤

  1. 从我们的下载页面下载最新的FOSSBilling版本。请务必不要下载预览版本,除非这是您特别追求的。
  2. 为您的FOSSBilling安装创建一个新的MySQL数据库和数据库用户。
  3. 如果您打算在安装时使用SSL(您应该这样做!),请在执行安装过程之前确保其设置和运行。
  4. 使用Cloudflare等产品时,请确保禁用JS和CSS文件的自动简化等选项。
  5. 如果您使用的是反向代理,请确保您的代理配置为发送 X-Forwarded-Host 和 X-Forwarded-Proto headers 到  FOSSBilling。

安装步骤

  1. 访问您域名的文档根目录,并确保控制面板创建的任何占位符文件被删除,这样它们就不会引起问题(占位符页面、.htaccess文件等)。
  2. 上传您之前下载的FOSSBilling版本,并将内容提取到文档根目录中。您的文档根现在看起来应该与此相似:
├── data├── install├── library├── locale├── modules├── themes├── vendor├── config-sample.php├── cron.php├── di.php├── index.php...
  1. 访问您为FOSSBilling设置的域名。如果您要使用SSL,请确保通过HTTPS访问域,以便应用程序可以自动为HTTPS配置自己。您应该被自动重定向到 domain.com/install/install.php。

如果您看到与此类似的页面,您来对地方了!The FOSSBilling installer landing page

  1. 按照屏幕上的步骤同意FOSSBilling许可证,输入您的数据库凭据,并为您的管理员帐户设置登录信息。
  2. 确保您正确配置默认货币。价格格式必须包含{{price}}才能正常工作,因为它被用作占位符值。只需在{{price}}的两侧输入货币符号。
  3. 点击安装。几分钟后,您应该会看到一个成功页面。

单击安装后遇到错误?在重试之前,您可能需要手动清空您为FOSSBilling创建的数据库。

安装后步骤

完成FOSSBilling安装程序中的步骤后,您只需配置cronjob,然后即可在软件本身中开始。

配置cronjob

FOSSBilling依靠cronjob执行重要操作,例如处理续订、过期订单、发送邮件等。因此,cron配置正确、可靠地运行以及设置为足够频繁地运行至关重要。

我们建议将cron配置为每5分钟运行一次。如果15分钟过去了,没有执行cron,FOSSBilling将在管理员面板中显示通知。如果您看到此消息,您需要尽快解决问题。FOSSBilling warning about cron execution

利用本地cronjob

cronjob还需要在FOSSBilling支持的PHP版本上运行。如果您遇到错误,您可能会遇到一个常见问题,即您的cronjob没有在配置的域相同的PHP版本上运行。有关故障排除步骤,请查看此论坛帖子以获取一些指针。

FOSSBilling将显示正确的cron命令,用于在安装完整页面和管理员面板中运行其cronjob。如果您需要再次找到它,请导航到 Settings -> Scheduled Tasks (/admin/extension/settings/cron).

Cron settings - correct cron command

利用远程服务激活cron

如果您发现无法使用本地cronjob运行cron,则可以使用远程服务调用给定的URL来执行cron,但首先您必须启用该功能。要做到这一点,导航到Settings-> Scheduled Tasks(/admin/extension/settings/cron) 然后启用cron API端点,然后单击“更新”

然后,您将能够使用外部服务页面上显示的URL来自动执行cronjob。

Cron settings - remote URL