3步零基础部署Nyaa：从环境配置到启动验证全指南

一、准备工作：环境与资源检查

1.1 开发环境检查清单

• Go语言环境（必填）：确保Go 1.16+已安装，验证命令：

  go version  # 需返回go1.16及以上版本号
  

• Git工具（必填）：用于克隆项目代码，验证命令：

  git --version  # 需返回有效版本信息
  

• 数据库（可选）：默认使用SQLite，如需MySQL需提前安装并创建数据库

1.2 项目资源获取

1. 克隆代码仓库：

   git clone https://gitcode.com/gh_mirrors/nya/nyaa
   cd nyaa
   

2. 查看项目目录结构（关键目录说明）：

   nyaa/
   ├── main.go               # 应用入口文件
   ├── config/               # 配置文件目录 ⚙️
   ├── controllers/          # 请求处理逻辑 📝
   ├── models/               # 数据模型定义 📊
   ├── public/               # 静态资源文件 🖼️
   └── templates/            # HTML模板文件 📄
   

二、核心模块解析：数据流向与功能划分

2.1 模块关联图（文字示意）

用户请求 → router(路由分发) → controllers(业务逻辑) → models(数据操作) → 数据库
       ↓                   ↓                     ↓
    中间件处理          模板渲染             数据验证/转换
       ↓                   ↓                     ↓
    响应结果 ← templates(页面生成) ← public(静态资源) ← config(配置读取)

2.2 关键目录功能详解

• controllers/：包含各业务模块的处理逻辑，如torrent/处理种子上传下载，user/处理用户认证
• models/：定义数据结构与数据库交互，如torrent.go定义种子信息模型
• config/：存放配置文件，default_config.yml提供基础配置模板

三、实战操作：配置与启动全流程

3.1 配置文件快速定位与修改

1. 复制默认配置文件：

   cp config/config_example.yml config/config.yml
   

2. 核心配置项说明（[config/config.yml]）：

   配置项	必填	默认值	说明
   server.port	是	9999	应用监听端口
   database.type	否	sqlite3	数据库类型（sqlite3/mysql）
   database.connection	否	data/nyaa.db	数据库连接字符串

3.2 应用启动与验证

1. 构建并启动应用：

   go build -o nyaa main.go
   ./nyaa  # 启动服务
   

2. 启动成功验证：
   • 访问 http://localhost:9999 出现网站首页
   • 查看终端输出，确认无错误日志

四、常见问题与解决方案

4.1 启动失败排查

• 端口占用：修改server.port配置项，使用未被占用端口
• 数据库错误：检查数据库连接字符串格式，确保数据库服务正常运行

4.2 页面异常处理

当出现404错误时，系统会显示NotFound页面：

解决方法：

1. 检查请求URL是否正确
2. 确认路由配置是否存在对应处理器（查看controllers/router/目录下的路由定义）

4.3 种子文件相关问题

上传种子时如遇"文件不存在"错误，会显示以下提示页面：

解决方法：

1. 确认上传文件格式为.torrent
2. 检查文件大小是否超过max_upload_size配置限制