> 规范网页：https://docs.tensuu.com/快速入门指南/首次使用.html ｜ Markdown：/快速入门指南/首次使用.md ｜ 文档修订：2026.10.26

# 首次使用：安装并启动

这篇帮你做什么：把天枢群管家在自己的电脑或服务器上启动，并打开管理页面（控制台）。不需要另装数据库，也不需要注册控制台账号；接入 QQ 所需的机器人账号和 OneBot 实现端需要另行准备。

## 开始前确认

- 一台 **Windows 64 位**电脑或服务器（当前发布包只提供 Windows 版 `datahub.exe`）。
- 你能拿到完整的 **Windows 64 位发布包**，内含 `datahub.exe`、`configs/`、`web/`。
- 默认配置使用 **6700** 提供 API、**6701** 提供控制台，两者都需要可用，不能被其他程序占用或被系统保留。控制台端口始终是 API 端口加 1，后面会讲怎么改。
- 一台用于打开管理页面的浏览器（Edge、Chrome 等）。

> ⚠️ **先读这段再部署**：控制台**没有登录密码、没有账号体系**。谁能打开这个网页，谁就能操作全部功能。请只把它部署在**你自己可信的电脑或内网**里，API 与控制台端口都不要直接开放到公网（默认是 6700 和 6701；改过配置时按实际值核对）；如需远程访问，请自行加装带访问控制的反向代理等网络层隔离。这不是疏漏，是当前版本的既定边界。

## 安装：把发布包放到目标位置

1. 把发布包目录整体复制到一个你方便管理、且**有读写权限**的位置。路径建议不含空格，例如 `D:\tensuu\`。
2. 本文使用直接运行程序的方式，不需要注册系统服务。以后想移除，应先正常停止程序，再确认数据库、部署配置、备份及自定义路径中的文件均已按需保留；不要直接删除正在使用的目录。

## 启动：运行 datahub.exe

1. 打开命令提示符（按 Win 键，输入 `cmd` 回车），执行：

   ```
   cd /d D:\tensuu
   datahub.exe
   ```

2. 窗口开始滚动日志即表示在启动。首次启动会自动完成两件事：
   - 在 `data\` 目录创建数据库文件 `datahub.db`（保存应用的数据库配置和记录；不包含程序目录里的全部文件）；
   - 创建 `logs\` 日志目录。
3. **怎样确认 API 正常**：再开一个命令提示符窗口，执行 `curl http://localhost:6700/ping`；返回 `{"message":"pong"}` 表示 API 可访问。改过端口时使用实际 API 端口；这一步不证明控制台文件或页面可用，继续按下面的地址检查控制台。

## 打开控制台

1. 在启动窗口找到 **Static Web Console**，用浏览器打开它给出的完整地址。默认配置下是 `http://127.0.0.1:6701/web/`，不是 API 端口 6700。若窗口提示 **Frontend index.html not found, serving API only**，表示当前只提供 API，请先核对发布包的 `web\index.html` 是否完整。
2. 直接进入"仪表盘"页面，**没有登录步骤**（原因见上文安全提示）。如果页面打开了"登录"样式的页面，说明你访问的是模板残留地址 `/web/login`，它不是真正的入口，请改用上面的完整地址。
3. 首次启动你会看到几样"自带"的东西，属于正常现象：
   - 一条名为 **默认连接** 的连接配置，状态显示"异常"（它没有填写地址，用来提醒你还需要配置机器人连接，见[连接机器人](连接机器人.md)）；
   - 监控方案里有一个**默认监控方案**，自带"加群 / 兼职 / 广告"三条示例规则。

## 数据在哪里、怎样停止

- **常见数据位置**：默认配置下，`data\datahub.db` 是数据库，`logs\` 是日志，`backups\` 是备份；部署配置在 `configs\`。如果改过存储路径，应按实际配置查找，不要只保留数据库就删除其他文件。备份目录与定期备份见[完成第一次配置](完成第一次配置.md)。
- **停止**：回到运行 `datahub.exe` 的命令提示符窗口，按 `Ctrl+C`，等待程序退出。不要用强制结束进程代替正常停止。停止后刷新浏览器将无法再从该程序加载控制台。
- **再次启动**：重复上面的启动命令即可，配置和数据都会保留。

## 只能在本机打开？默认是的

默认配置里 `server.host` 是 `"127.0.0.1"`，意思是控制台服务**只接受来自这台电脑本身的访问**。机器人通信还需要单独核对连接方式、监听地址和端口，不能因为控制台能打开，就认定另一台设备上的实现端也能接入。如果你确实需要从内网另一台电脑打开控制台：把 `config.yaml` 里的 `host` 改为 `"0.0.0.0"` 并重启；改了之后，同一内网的所有设备都能打开这个无密码的控制台，请确认网络环境可信，并不要同时开放到公网。

## 没成功先检查什么

- **双击 `datahub.exe` 窗口一闪而过**：多半是端口被占用或配置文件格式错误。先在命令提示符里用上面的方式启动，看窗口里留下的错误文字。
- **提示端口被占用 / 页面打不开**：先看启动窗口指出的是 API 端口还是控制台端口。确认不可用后，可修改 `configs\config.yaml` 里 `server:` 下的 `port`（例如改成 `6800`，同时确认 `6801` 也可用），保存后重新启动，按 **Static Web Console** 日志访问控制台。Windows 的“访问套接字的方式不被允许”（10013）也可能来自系统保留端口，并不一定有别的程序占用；不要因此关闭防火墙或强行结束无关程序，见[常见问题](常见问题.md)。
- **浏览器打不开但 ping 正常**：`/ping` 只证明 API 可访问。控制台要使用日志给出的地址（默认 `http://127.0.0.1:6701/web/`，带 `/web/`）；若没有控制台地址并提示只提供 API，先确认 `web\index.html` 存在，并从发布包目录启动程序。
- 更多排查见[常见问题](常见问题.md)。

## 改端口：一个真实例子

1. 用记事本打开 `configs\config.yaml`，找到开头几行的：

   ```yaml
   server:
     host: "127.0.0.1"
     port: 6700
   ```

2. 把 API 端口 `6700` 改成可用的端口（例如 `6800`），同时确认它加 1 后的控制台端口 `6801` 也可用，再保存。带静态控制台时 API 端口须在 1–65534 之间。
3. 正常停止后重启 `datahub.exe`，核对启动日志。此例 API 为 `http://127.0.0.1:6800/ping`，控制台为 `http://127.0.0.1:6801/web/`；访问地址以 **Static Web Console** 日志为准。
4. **注意**：配置文件在启动时读取，改完必须重启才生效。若设置了网络访问控制，API 与控制台两个端口都要按新值核对，不要只保护其中一个。

## 更多说明

- `config.yaml` 里还有日志、备份目录、时区等部署项。一般保持默认即可开始使用；本文不逐项展开，需要时再到对应功能页查。
- 系统的时间边界（例如 AI 每日额度按"哪一天"计算）由 `deployment.timezone` 决定，默认 `Asia/Shanghai`，留空或填错也是这个值；改它需要重启。
- 想先理解机器人、连接、群和方案的关系：[工作方式与作用范围](../核心概念/工作方式与作用范围.md)。
- 想接着做：[连接机器人](连接机器人.md) → [完成第一次配置](完成第一次配置.md)。