← 全部教程

教程 1 / 9

从全新 VPS 到您的控制台。

选择服务器、连接三个主机名并完成首次登录。

完成后您将拥有

可用的 HTTPS 控制台和受保护管理员账户。

1. 准备 Linux VPS

在托管服务商面板创建全新的 x86-64 Linux VPS ,具有 root 权限。Ubuntu 24.04 LTS 或 Debian 12+ 是简单直接的选择。请使用仍在维护的系统版本;原生安装程序不涵盖 ARM。

小型商店可从以下配置开始: 2 vCPU、4 GB RAM 和 60 GB SSD。轻度使用可在 1 vCPU、2 GB RAM 和 20 GB 磁盘运行,但应为操作系统、付款历史、备份和更新预留空间。此服务器不运行区块链节点。

添加 SSH 公钥,记录服务器 IP,并在首次连接时验证 SSH 主机指纹。切勿分享 SSH 私钥。参见 完整要求 或 可选的 Docker 安装方式.

2. 将域名指向服务器

在域名 DNS 面板添加这些记录。请替换 example.com 及 IP 为您自己的值。

主机名记录用途
merchant.example.comA → VPS IPv4您的控制台
pay.example.comA → VPS IPv4客户结账
api.example.comA → VPS IPv4您的集成

可以自定义子域名,安装程序会询问。仅在 IPv6 确实能到达此 VPS 时添加 AAAA 记录。即使 A 记录正确,旧 AAAA 记录也可能破坏 HTTPS 验证。

Cloudflare:安装期间关闭代理,设为仅 DNS。 设置和 HTTPS 验证完成后可重新开启。请加密连接源站,最好使用有效证书和 Full (strict)。

3. 检查防火墙

允许入站 TCP 80 和 443 ,VPS 防火墙和托管服务商防火墙都需放行。保持实际 SSH 端口开放。出站 HTTPS 和 DNS 必须正常。

不要暴露 PostgreSQL 或应用内部端口。安装程序不会替您更改防火墙规则。修改访问规则时保持当前 SSH 会话开启,以免将自己锁在外面。

4. 运行签名安装程序

以 root 通过 SSH 连接并运行:

bash <(curl -fsSL https://releases.whollycrypto.com/setup_wholly.sh)

设置会询问域名、HTTPS 联系邮箱、默认法币和 HTTP Basic 用户名/密码。密码可自行选择或由安装生成。请安全保存。

安装程序验证签名版本,并设置 PostgreSQL、Nginx、HTTPS 和系统服务。请等待成功消息。 Basic Auth 凭据是独立安全层,不是之后创建的控制台账户。

先检查,或恢复中断的安装

安装前运行兼容性检查:

bash <(curl -fsSL https://releases.whollycrypto.com/setup_wholly.sh) --check

修复报告的错误,然后恢复安装。不要删除安装目录或重新生成钱包密钥。

bash <(curl -fsSL https://releases.whollycrypto.com/setup_wholly.sh) --resume

5. 注册并保护账户

打开商户主机名,通过 Basic Auth,再以邮箱和强密码注册首位管理员。选择安装模式、语言和时区,并阅读链接中的条款及隐私政策。 模式选择是永久的。 读取 商家模式或运营商模式 后再提交。

在 设置 → 账户中启用双重验证。在 设置 → 系统中检查区域币种/时区默认值和在线域名。区域默认值影响新建条目,不会重写现有项目。

首个符合条件的安装会一次性获得 US$10 欢迎额度 ,注册并连接后自动发放。请查看 设置 → 费用 中的计费状态。 处理额度如何运作 →

6. 收款前检查

打开 设置 → 区块链连接。请看扫描器就绪状态,而不仅是节点健康。为要使用的链保留独立备用服务商。

将此服务器作为热钱包服务器保护:限制管理员访问、安装安全更新,并在 VPS 之外保留私密备份。钱包导出包含机密,切勿上传网站或支持工单。 服务器安全清单 →

现在可以创建项目和店铺了。向客户公布付款方式前,先对每种方式做一笔小额真实测试。