35
1
0
小氢云网盘系统部署教程
2026-09-04
2026-09-04
文章摘要
|
小氢云网盘系统支持免费使用。部署前请先到授权站领取授权，再按本文在宝塔面板完成安装与启动。
授权地址：https://auth-v1.ithxs.com/
注册账号后进入个人中心，按页面提示获取本系统对应的授权信息（密钥稍后会在程序启动时填写）。
1. 安装宝塔面板
推荐使用宝塔面板管理服务器（进程守护、网站反代、数据库与 Redis 都更方便）。若尚未安装，请前往官网安装：
安装完成后，建议先装好：
- MySQL
- Redis
- Nginx（用于域名反代与 HTTPS，按需）
2. 上传程序文件
将安装包上传到服务器合适目录（例如 /www/wwwroot/xqy-storage），解压后可看到主程序二进制 server，以及配置文件等资源。
说明：server 即为网盘系统主程序，后续用宝塔「项目 / 进程守护」来启动它。
3. 创建数据库并确认 Redis
在宝塔中新建一个 MySQL 数据库，并记下：
- 数据库名
- 用户名
- 密码
- 主机地址（本机一般为
127.0.0.1）与端口（默认3306）
同时确认 Redis 已安装并正常运行，记下 Redis 地址、端口与密码（若设置了密码）。
4. 修改系统配置
打开程序目录下的配置文件（常见为 config/config.yaml，若只有模板文件请先复制一份再改），重点核对两块：
- 数据库配置：填入上一步创建的 MySQL 信息
- Redis 配置：填入 Redis 地址、端口、密码与前缀（如有）
其余端口、站点相关项可按环境调整。若某项含义不清楚，可将配置片段发给 AI 助手对照说明后再改，避免写错导致启动失败。
5. 在宝塔创建项目（进程守护）
在宝塔中创建对应项目 / 守护进程，工作目录指向程序解压目录，启动命令指向 server 二进制（或面板提供的 Go / 通用项目启动方式）。
创建后确认：
- 进程状态为运行中
- 日志无数据库 / Redis 连接错误
- 如需外网访问，再为域名配置 Nginx 反向代理到程序监听端口
6. 填写授权，完成上线
程序启动后，按页面提示填入在授权站获取的授权密钥。填写成功即可正常使用管理后台与网盘功能。
7. 其他说明
日志切割（强烈建议开启）
长时间运行后，程序日志会持续增大。请在宝塔日志 / 进程相关设置中开启日志切割（按天或按大小），避免磁盘被日志占满。
常见排查
- 启动失败 / 端口占用：确认旧进程已停止，配置中的端口未被占用
- 连不上数据库：核对库名、账号、密码、主机与端口是否与宝塔一致
- Redis 报错：确认 Redis 已启动，密码与配置一致
- 授权失败：回到授权站核对产品与密钥是否对应本系统
按以上步骤完成后，小氢云网盘即可在服务器上稳定运行。若部署过程中遇到报错，可把日志截屏发到交流群或联系站长协助排查。