Marzneshin 的管理对象比单机面板多一层：Marznode 运行代理内核，Inbound 接收连接，Host 告诉客户端怎样找到入口，Service 决定用户能使用哪些入站。本文先完成同机部署并串起这四个对象。
资料核对：2026 年 9 月 30 日。下方配图为科学之家绘制的操作流程示意，具体菜单以所用版本为准。
01 · 准备与填写约定
准备一台具有管理员权限、能够访问项目发布源的 Linux 服务器，以及支持所选协议的客户端。记录公网地址和已占用端口；已有服务的主机先做快照。文中的 SERVER_IP、USER、示例密码和证书路径必须换成自己的值。
先确定一个测试目标：只创建一个入站或用户，导入一台客户端并验证。这能让安装、账号和连接三个阶段的问题分别定位。
02 · 安装与首次进入
在目标 Linux 服务器的 SSH 终端操作。先下载并查看官方脚本，再执行安装；安装命令不在日常使用的电脑上运行。
curl -fL https://github.com/marzneshin/Marzneshin/raw/master/script.sh -o marzneshin-install.sh
less marzneshin-install.sh
sudo bash marzneshin-install.sh installsudo marzneshin cli admin create --sudo创建管理员后，可通过 SSH 转发访问后台：在自己的电脑运行 ssh -L 8000:localhost:8000 USER@SERVER_IP，再打开 http://localhost:8000/dashboard/。长期对外管理按官方反向代理说明配置 HTTPS。
03 · 建立第一条可用连接
- 先创建 Service（服务），给它一个易辨认的名字。Service 是给用户分配入站权限的集合，不是订阅 URL。
- 核对本机 Marznode 在线，确认它使用的内核与入站配置可用。官方 compose 示例将本机管理监听绑定到 127.0.0.1；不要把这种本地管理设置直接照搬成公网节点连接。
- 在节点中选择实际存在的 Inbound，将它加入刚创建的 Service。官方安装器下载的 Marznode 示例含 vmess HTTP 入站，示例端口 2086，可用它验证对象关联；实际启用内容以安装版本为准。检查 Host 的公网地址和端口。长期配置应再依据核心文档设置合适的 TLS / REALITY 传输。
- 新建用户并授予这个 Service，设置用户状态、配额和到期时间。保存后打开用户的分享 / 订阅入口，确认导出的节点与选定的入站一致。
04 · 看图核对连接信息
| 设置或现象 | 填写方法与检查方向 |
|---|---|
| Node | 运行代理核心的节点；离线时先检查节点服务与管理连接。 |
| Inbound / Host | Inbound 管监听；Host 管导出给客户端的连接信息。 |
| Service | 把可用入站组织成用户可获准使用的集合。 |
| User | 授予 Service 后，用户才能取得对应节点。 |
05 · 导入客户端并验证
将用户订阅导入支持其格式的客户端。若浏览器能打开用户页面，但客户端更新为空，检查订阅的 User-Agent 匹配规则是否覆盖该客户端。官方文档说明没有命中规则时可能返回空内容；不要直接判断为节点故障。
- 确认客户端拿到了节点，而不是网页、管理地址或错误提示。
- 重新建立连接，查看一次真实请求的结果；单独显示“已连接”不能替代访问测试。
- 对照同一时段的客户端日志和服务端日志 / 用量，确认测试用的是新配置。
06 · 常见问题
| 设置或现象 | 填写方法与检查方向 |
|---|---|
| 用户有账号却没有节点 | 依次检查 Service 是否包含入站、用户是否获得该 Service、Host 信息是否完整。 |
| 节点在线但连接失败 | 管理通道可达与代理入站可达是两件事。检查具体入站端口、核心日志和导出的地址。 |
| 官方文档站无法打开 | 本篇附有官方 GitHub 文档仓库链接，安装和对象关系依据该仓库核对，避免依赖不可用的站点入口。 |
07 · 备份与后续维护
保存 /var/lib/marzneshin、/etc/opt/marzneshin 的配置和数据库，同时保留 /var/lib/marznode 的核心配置及证书。恢复后先确认 Node 在线，再核对 Service、入站和用户授权。数据库服务另行部署时使用其一致性备份方法。
每次只调整一类设置，并保留可恢复的旧配置。改端口、凭据或域名后重新生成分享信息；客户端也需要同步更新。
08 · 官方资料与下一步
文字与流程图由科学之家整理制作；安装来源和协议字段参见上述官方资料。本文未附带任何服务商套餐或推广链接。
