# 安装主控

一条命令装好主控：系统要求、安装做了什么、装完怎么登录与自检。

主控是 gocdn 的管理面,装一台就够。本篇说明系统要求、安装命令做的事和装完的自检。


## 系统要求
- Debian 13 / Ubuntu 26.04 或更新的 Linux,x86_64 或 arm64,有 systemd。
- 内存 4G 以上,/var/lib 可用空间 ≥ 20G。
- 能访问公网;不要和节点装在同一台机器上。
- 以 root 执行。

## 安装
试用或购买后,安装命令会发送到您的邮箱。登录服务器,把命令整行粘贴执行:

```cmd
t=$(mktemp) && curl -fsSL https://服务商地址/i/•••••••• -o "$t" && bash "$t"
```

命令先把脚本下载到临时文件,下载成功才执行;网络不通时整条命令会报错退出,不会误以为装好了。

命令里没有指定版本时,装的是物料站上的新装默认版本(latest);这个版本须先验过超管签名才采用,签名不对(例如被改成指向旧版)脚本直接退出,不装、也不改本机版本。

:::tip
命令里带一次性令牌,72 小时内有效、只能用一次。过期了请联系服务商重新发一条。
:::

## 安装做了什么
装依赖(MariaDB、ClickHouse 等)、装主控程序与 systemd 单元、创建第一个管理员、启动服务、向授权服务登记并做本机健康检查。可以重复执行:已经做好的会跳过,缺的会补上,口令、钥和管理员都不会重建。

## 装完做什么
结束时屏幕会打印面板地址,末行是 `MASTER_INSTALL_DONE <版本>`。第一个管理员的用户名是 `admin`,初始口令在 `/root/gocdn-admin.pass`;登录后先改口令,再删掉这个文件。

:::warn
节点安装命令里的主控地址要让节点能连上。主控在云主机 NAT 后面、或您使用内网地址打开面板时,先到「系统管理 › 升级与维护 › 节点通信」填好「节点通信公网地址」,再去取节点命令,见[添加节点](https://www.gocdn888.com/zh/guide/add-node)。
:::

## 自检
- 浏览器能打开面板地址并登录。
- 「系统管理 › 升级与维护 › 主控升级」里能看到当前版本。
- 「系统管理 › 系统设置」里「授权」状态正常;授权相关见[授权与增值功能](https://www.gocdn888.com/zh/guide/license)。

下一步:[添加节点](https://www.gocdn888.com/zh/guide/add-node)。