Appearance
n8管理后台使用教程
创建项目
创建一个新项目有以下几个部分：
- 服务器规格
- 规格分组
- 定价计划
- 项目列表（创建项目）
1.1 服务器规格
位置：服务器管理；用于创建各种型号的服务器，提供n8用户进行选择。
1.2 规格分组
位置：服务器管理；在创建项目时需要选择规格分组，在n8平台，每个项目都有属于自己的规格，而这里就是给项目分配它的规格。
1.3 定价计划
位置：服务器管理；每种不同的服务器规格都会有不同价格，在这里对服务器规格的价格进行设置。
1.4 项目列表（创建项目）
位置：项目模块；管理着平台所有的项目。一个完整可用的项目包含以下几个模块：
- 参数
- 脚本
- 镜像
- 状态（已发布=公共可用）
1.4.1 参数
这里参数是给脚本使用的魔法变量，同时也是n8平台的项目配置需要填写的参数。规定了该项目启动需要传递那些参数，例如：钱包地址、proxyip、proxy端口等。
1.4.2 脚本
脚本是启动项目的必要环节，一个项目至少需要有一个安装脚本，这个脚本如果需要传递用户的自定义配置。就使用参数进行传递，在使用脚本时，系统会自动将参数替换为实际的配置数据。
1.4.3 镜像
运行项目的系统镜像，所有的配置都必须配置完整。在配置时要注意镜像的平台和区域，如果填写错误就会开机失败。
项目管理
项目状态管理
项目状态说明：
- 草稿：项目正在配置中，用户不可见
- 私有：项目配置完成，进行内部测试，只有测试账号可见
- 已发布：项目公开可用，用户可以创建实例
- 已下线：项目暂时不可用，但保留配置
系统监控
实例监控
位置：服务器管理 > 实例管理
功能：
- 查看所有运行中的服务器实例
排查异常
开机失败排查
问题现象：n8平台创建的服务器无法正常启动
排查步骤：
查看队列日志
- 位置：
运营模块>队列日志 - 查看内容：开机参数、错误信息、执行时间
- 重点关注：参数传递是否正确、脚本执行是否成功
- 位置：
检查项目配置
- 验证参数配置是否完整
- 检查脚本语法是否正确
- 确认镜像配置是否匹配
验证云服务商接口
- 检查API密钥是否有效
- 验证区域和镜像ID是否正确
- 确认账户余额是否充足
常见错误及解决方案：
| 错误类型 | 可能原因 | 解决方案 |
|---|---|---|
| 镜像不存在 | 镜像ID错误或区域不匹配 | 检查并更新正确的镜像ID |
| 参数验证失败 | 用户输入不符合验证规则 | 完善参数验证规则和提示信息 |
| 脚本执行失败 | 脚本语法错误或权限不足 | 检查脚本代码，确保有执行权限 |
| 网络连接超时 | 云服务商API响应慢 | 增加超时时间或重试机制 |
| 余额不足 | 云服务商账户余额不够 | 充值或更换云服务商账户 |
最佳实践
项目配置最佳实践
参数设计
- 参数名称要见名知意
- 提供详细的参数说明
- 设置合理的默认值
- 添加必要的验证规则
脚本编写
- 使用标准的脚本模板
- 添加充分的错误处理
- 记录详细的执行日志
- 定期测试脚本的有效性
镜像选择
- 选择稳定的官方镜像
- 定期更新镜像版本
- 预装常用的软件和依赖
- 针对不同区域准备镜像
常见问题
Q1：如果出现购买算力失败应该怎么解决？
A1: 可以查看排查异常模块。
文档版本：v1.0
最后更新：2025年08月
维护人员：系统管理团队