文档 / 用 NimboBilling 出售主机——安装与最初几步

用 NimboBilling 出售主机——安装与最初几步

NimboBilling 是随每个付费 Nimbopanel 许可证附带的商店与计费应用。它是一款独立的应用,不是面板的一部分:面板不收取任何付款,也不提供任何销售页面。NimboBilling 会在你自己的域名上为你提供一家商店、发票、客户账户和一个帮助台,并且在一张发票付清时,替你在面板上创建主机账户。本指南讲的是安装,以及最初的一个小时。这款应用能做什么,见 NimboBilling 页面;设置的简短版本见 营销网站。

只有管理员或经销商才能安装它,要从他们自己的会话里,装到一个属于他们自己的主机账户上。

开始之前

  • 一个付费许可证。 在免费(Free)层级上,目录会把 NimboBilling 显示为灰色,并注明“需要付费许可证”。
  • 一个专门放商店的主机账户。 它的主域名就是商店将要使用的地址(yourbrand.com,或者 shop.yourbrand.com 这样的名字),并且这个名字要指向服务器。NimboBilling 会占用该站点的根目录,所以请使用一个没有其他网站的账户。它始终使用 HTTPS。
  • 该账户上要有 PHP 8.3 或更高版本。 如果账户运行的是更旧的版本,安装卡片会给出警告;请先在 PHP 版本 下更改。
  • 你自己的会话。 不要在用 登录 打开某位客户的面板之后安装它。

逐步安装

  1. 在 账户(Accounts) 里,打开该账户上的 管理 → 应用(Manage → Apps)。一个快捷方式:搜索工具 里有“销售主机(NimboBilling)”,它会带你到“账户”页面,并且在“应用”窗口打开时已经选中了 NimboBilling。
  2. 在列表里选择 NimboBilling。它的卡片会说明它是什么、需要什么,每个输入框都有一行帮助。
  3. 填写表单。这里没有文件夹输入框,因为 NimboBilling 始终占用域名的主地址:
    • 站点标题(Site title) —— 你的商店的名称。
    • 你的姓名(Your name) —— 只显示在应用内部。你用邮箱地址登录,而不是用这个姓名。
    • 管理员邮箱(Admin email) —— 你用它登录,应用也把给你的消息发到这里。
    • 管理员密码(Admin password) —— 输入至少 12 个字符、包含字母和数字的密码,或者留空,让系统替你生成一个强密码。
    • 语言(Language) —— 应用管理后台起始使用的语言,也是商店的默认语言:English 或 Bahasa Indonesia。这个选择同时决定商店起始使用的货币和时区。选 English 时,起始是美元和 UTC;选另一种语言时,起始是通常与它搭配的货币和时区。这三项之后都可以更改(见下文)。
  4. 按 安装。大约需要一分钟。

如果该域名已经有一个站点

面板会先问你,然后才动手。一个标题为 要替换此域名上的站点吗? 的对话框会列出它发现的文件,并说明会发生什么:NimboBilling 将成为该域名的站点,当前的站点在安装一完成就会停止提供服务,你的文件不会被删除,但与应用自带文件同名的文件会被替换。之后移除 NimboBilling 会清空该文件夹。安全的按钮 取消 是获得焦点的那个。要保留旧站点,就取消,并把 NimboBilling 安装到一个新的主机账户或域名上,或者先做一次备份。

安装之后的卡片

卡片会显示商店地址和管理后台地址、你的邮箱、你的姓名和密码,每一项都带一个 复制 按钮。请现在保存密码:它只显示一次。

两个地址都是安全(https)地址。新名称的证书需要几分钟,所以在它就绪之前,卡片会把地址显示为纯文本并附一条说明,等证书生效后再自动把它们变成链接(它会显示“安全地址已就绪”)。在那之前打开商店,会看到证书警告。

第二张卡片写着 NimboBilling 已连接到此面板。安装期间,面板为商店创建了一个名为 NimboBilling 的 API 令牌,可访问账户(读取和更改),商店则用它来登记这台面板,所以一笔已付款的订单无需更多设置就能创建主机账户。这个令牌列在 API 令牌 下,你可以在那里撤销它;移除应用时它也会被撤销。要检查连接,请在 NimboBilling 中打开 Services → Panel servers,然后按 Test connection。如果面板没能创建令牌,卡片会列出手动把两者连接起来的步骤。应用的调度任务行会替你加进该账户的 定时任务 里;如果加入失败,卡片会显示需要自己添加的那一行。

卡片上还有一行话很重要:在你于 Settings → Gateway: Manual transfer 下填入银行账户信息之前,客户看不到任何付款方式。

全新商店里有什么

全新安装会一次性填入一个示例商店,这样商店的各个菜单在首次访问时就能正常使用,而不是通向空白页面:

  • 分成四组的示例方案:共享主机、VPS 服务器、一台独立服务器和域名,
  • 一套入门帮助中心,包含关于下单、付款、服务和你的账户的文章,
  • 几篇已发布的博客文章,以及两条在你发布之前一直保持 草稿 状态的公告。

其中的每个名称、规格和价格都只是示例。示例方案按美元标价;如果你在安装时选了另一种语言,则按该商店的货币标价。主机和服务器方案没有关联任何面板服务器,所以它们的订单会等你的员工处理,直到你把产品关联到你的面板服务器,以及你某个套餐的确切名称(产品上的 Panel server 和 Package name on the panel)。在开店之前,请把示例方案换成你自己的方案,或者把它们删除。没有任何东西会把它们带回来:商店会记下示例已经提供过一次。

让你的商店准备就绪

从 NimboBilling 1.0.7 起,新商店要求每一位员工都使用两步登录:所有者的第一次登录会直接进入设置。在 1.0.7 之前安装的商店不会被切换;它的仪表盘会向所有者推荐这一做法,设置项是 Settings → Security → Require 2FA for all staff。

管理后台的仪表盘上会显示一张 Getting your store ready 卡片,直到每一步都完成。每一步是否打钩,由数据本身决定,而不是手动勾选:

  1. 连接你的主机面板(Connect your hosting panel) —— 只有在安装没有已经替你连接好时才会显示。Services → Panel servers。
  2. 添加你的公司邮箱(Add your company email) —— 显示在发票上,客户用它来联系你。Settings → General。
  3. 设置外发邮件(SMTP)(Set up outgoing email (SMTP)) —— 没有它,发票和提醒就无法送达客户。Settings → Email (SMTP)。
  4. 设置收款:先从银行转账开始。 见下文。
  5. 把示例方案换成你自己的方案。 当存在你自己的方案,或者你编辑过某个示例方案时,这一步就算完成。
  6. 选择商店的外观 —— 在 Theme, logo & slides 下选一个现成的模板,然后调整颜色、字体和 logo。

价格、加价与推荐

商店里的价格是产品的基础价格加上一笔 加价。在 Settings → Billing & Pricing 下,Default markup (%) 起始为 10%,单个产品可以在它自己的页面上设置一个专属的数值。这笔加价是 推荐佣金 的资金来源:在你于 Settings → Referrals & Commissions 下启用之前,推荐佣金是关闭的,而且最多可以达到五级。

Add a markup to selling prices 是它的开关。关闭后,每个产品都按基础价格出售,也就没有资金用于推荐佣金。它适用于新订单以及之后的续费;已经开出的发票不会改变。从 NimboBilling 1.0.7 起,新商店的示例方案也遵循默认加价,所以关闭这个开关会立刻体现在它们的价格上(一个 3.99 美元的方案,在默认 10% 加价下按 4.39 出售)。用更早版本安装的商店,其示例方案保留各自设置为 0% 的专属加价。当员工在开关关闭时按高于目录的价格下单,差额算作基础价格,而不是加价,因此不会为任何推荐佣金提供资金。

税费

在你把它打开之前,税费是关闭的:Settings → Billing & Pricing → Charge tax (VAT/GST)。税率放在 Tax rules 下。其中的 Common tax rates 区块可以一键加入 18 个国家之一的标准国家税率。这样只会创建一条规则,绝不会打开税费,而且税率会变化,所以请向你的会计确认。对于欧盟内部的销售,你还可以设置自己所在的国家,对企业客户启用反向征收,并让客户的增值税号通过欧盟委员会的 VIES 服务来核验(默认开启;当 VIES 无法连接时,该号码视为未核验、照常征收增值税,员工可以手动把它标记为已核验)。

时区与语言

Settings → General 里有商店的 Time zone。管理后台、客户页面、PDF 和邮件里的日期和时间,以及每天自动计费运行的时刻,都遵循它。请在第一批发票之前就设置好:更改时区时,已保存的日期不会变,所以之后某张发票的到期日可能显示为提前或推后一天,设置页面也会这样提示。

同一个页面里还有 Admin panel language(English 或 Bahasa Indonesia),它适用于你所有员工看到的管理后台的菜单、表单和手册。商店本身的文字保存在商店的主语言里,也就是安装时选的那一种,持有这些文字的字段在英文管理后台里标有 (main language);从 NimboBilling 1.0.7 起,示例商店也是用那种语言写的。它不会改变客户看到的语言;那一项在 Settings → Language 下。默认货币也在这个页面上,连同客户可以选用的货币。

收款

支付网关在 Settings 下设置,每个网关一个页面。

  • 银行转账 排在第一位,因为它不需要网关账户。它从一开始就已开启,但只有在你把 Settings → Gateway: Manual transfer 里的示例换成你真实的银行账户信息之后,才会向客户提供。客户上传转账凭证,由你的员工在 Payments 下批准。
  • Stripe(银行卡):Settings → Gateway: Stripe (cards)。它有测试模式;请先用它。
  • PayPal:Settings → Gateway: PayPal,带一个沙盒开关。

对于 Stripe 和 PayPal,设置页面会显示一个 Webhook URL 以及需要勾选的事件。请在网关那边添加它,否则客户关闭标签页之后才完成的付款会延迟确认。

哪些已经验证。 Stripe 仅在其测试模式下得到验证。PayPal 尚未用真实付款完成端到端验证。在宣传你的商店之前,请自己先做一笔小额的真实购买。应用自带的 Manual / guide 里有每个网关的分步说明。

更新

当目录里出现更新版本的 NimboBilling 时,管理 → 应用 会在它旁边显示 有可用更新 和一个 更新 按钮。面板会先做一次备份,替换应用的代码,保留你的 .env 配置,运行应用自己的升级,并检查站点是否有响应。如果它没能顺利起来,面板会把旧版本放回去,并告诉你站点没有变化。你的产品、客户、发票和设置都保持原样。在某个版本之前安装的商店,不会被写入新的示例文字。

移除它

管理 → 应用 → 移除,然后输入 remove 来确认。这会删除商店的文件和数据库,连同它的发票、客户和工单,所以请先做备份。文件夹会被清空,商店使用的 API 令牌也会被撤销。它所创建的主机账户是面板的账户,不属于这款应用。

出了问题时

  • 卡片提示该文件夹已经有文件。 请阅读上面的对话框说明;如果想保留现有的站点,就选一个新的账户。
  • 安装后立刻打开商店地址,显示证书警告。 等几分钟:证书就绪后,卡片会把链接打开。
  • 客户看不到任何付款方式。 请在 Settings → Gateway: Manual transfer 下添加你的银行账户信息,或者开启某个支付网关。
  • 一笔已付款的订单没有创建账户。 打开该产品,检查它是否关联到你的面板服务器,以及你某个套餐的确切名称。示例方案没有做关联。另见上文的连接检查。
  • 安装因 PHP 被拒绝。 该账户运行的版本低于 8.3。请在 PHP 版本 下更改,然后重新安装。
  • 在列表里,NimboBilling 是灰色的。 服务器处于 Free 层级;参见 许可如何工作。

相关: 营销网站 · 经销商指南 · 许可如何工作 · 故障排查