# nnet 域名配置指南（已弃用）
## ⚠️ 注意
**当前项目已改用 GitHub 作为模块路径**：`github.com/noahlann/nnet`
本文档仅作为参考，说明如何配置自定义域名。如果您需要使用自定义域名，可以参考本文档。
## 一、域名配置概述
使用自定义域名（如 `go.noahlan.cn`）作为 Go 模块路径，这样可以：
- 不依赖特定 Git 平台（GitHub、Gitee等）
- 可以随时切换代码仓库
- 更专业的模块路径
- 更好的控制权
**当前配置**：项目使用 `github.com/noahlann/nnet`，无需域名配置。
## 二、域名 DNS 配置
### 2.1 配置 DNS 记录
需要在域名 DNS 中配置以下记录：
```
类型: CNAME 或 A
名称: go
值: gopkg.in 或直接指向 Git 服务器 IP
TTL: 3600
```
### 2.2 Go 模块路径重定向
Go 工具会访问 `https://go.noahlan.cn/nnet?go-get=1` 来获取模块信息，需要返回以下 HTML：
```html
go.noahlan.cn/nnet
```
### 2.3 实现方式
#### 方式1：使用 gopkg.in 服务（推荐，最简单）
如果使用 gopkg.in 服务，只需要：
1. 在 GitHub/Gitee 创建仓库
2. 在 gopkg.in 注册：https://gopkg.in
3. 配置重定向规则
#### 方式2：自建 HTTP 服务
创建一个简单的 HTTP 服务，处理 `?go-get=1` 请求：
```go
package main
import (
"fmt"
"net/http"
)
func handler(w http.ResponseWriter, r *http.Request) {
if r.URL.Query().Get("go-get") == "1" {
html := `
go.noahlan.cn/nnet
`
w.Header().Set("Content-Type", "text/html")
fmt.Fprint(w, html)
} else {
http.Redirect(w, r, "https://github.com/yourusername/nnet", http.StatusFound)
}
}
func main() {
http.HandleFunc("/nnet", handler)
http.ListenAndServe(":80", nil)
}
```
#### 方式3：使用 Nginx 配置
```nginx
server {
listen 80;
server_name go.noahlan.cn;
location /nnet {
if ($arg_go-get = "1") {
return 200 '
go.noahlan.cn/nnet
';
add_header Content-Type text/html;
}
return 302 https://github.com/yourusername/nnet;
}
}
```
## 三、多仓库支持
### 3.1 支持多个 Git 仓库
可以配置多个 Git 仓库作为备用源：
```html
```
Go 工具会按顺序尝试这些源。
### 3.2 动态选择仓库
可以根据用户位置或网络条件动态选择仓库：
```go
func handler(w http.ResponseWriter, r *http.Request) {
// 检测用户IP或User-Agent
// 国内用户 -> Gitee
// 国外用户 -> GitHub
var gitURL string
if isChinaIP(r.RemoteAddr) {
gitURL = "https://gitee.com/yourusername/nnet.git"
} else {
gitURL = "https://github.com/yourusername/nnet.git"
}
html := fmt.Sprintf(`
go.noahlan.cn/nnet
`, gitURL, gitURL)
w.Header().Set("Content-Type", "text/html")
fmt.Fprint(w, html)
}
```
## 四、Go 环境配置
### 4.1 配置 GOPROXY
```bash
# 设置 Go 代理（支持国内镜像）
go env -w GOPROXY=https://goproxy.cn,https://goproxy.io,direct
# 或者使用官方代理
go env -w GOPROXY=https://proxy.golang.org,direct
```
### 4.2 配置 GOSUMDB
```bash
# 使用官方校验和数据库
go env -w GOSUMDB=sum.golang.org
# 或者禁用（不推荐，除非是私有仓库）
# go env -w GOSUMDB=off
```
### 4.3 验证配置
```bash
# 测试模块路径
go list -m go.noahlan.cn/nnet
# 或者直接下载
go get go.noahlan.cn/nnet
```
## 五、版本标签
### 5.1 创建版本标签
```bash
# 创建标签
git tag -a v1.0.0 -m "Release v1.0.0"
# 推送到所有仓库
git push origin v1.0.0
git push gitee v1.0.0
git push private v1.0.0
```
### 5.2 使用版本
```bash
# 使用特定版本
go get go.noahlan.cn/nnet@v1.0.0
# 使用最新版本
go get go.noahlan.cn/nnet@latest
# 使用最新主版本
go get go.noahlan.cn/nnet@v1
```
## 六、测试域名配置
### 6.1 测试 HTTP 响应
```bash
# 测试 go-get 请求
curl "https://go.noahlan.cn/nnet?go-get=1"
# 应该返回包含 go-import meta 标签的 HTML
```
### 6.2 测试 Go 模块获取
```bash
# 在新的项目中测试
mkdir test-project
cd test-project
go mod init test
# 尝试获取模块
go get go.noahlan.cn/nnet
# 检查 go.mod
cat go.mod
```
### 6.3 验证模块信息
```bash
# 查看模块信息
go list -m -versions go.noahlan.cn/nnet
# 查看模块详情
go list -m -json go.noahlan.cn/nnet
```
## 七、常见问题
### 7.1 Go 工具无法找到模块
**问题**：`go get go.noahlan.cn/nnet` 失败
**解决方案**：
1. 检查 DNS 配置是否正确
2. 检查 HTTP 服务是否返回正确的 meta 标签
3. 检查 Git 仓库 URL 是否正确
4. 使用 `-v` 参数查看详细错误：`go get -v go.noahlan.cn/nnet`
### 7.2 模块路径不匹配
**问题**：`go.mod` 中的模块路径与导入路径不匹配
**解决方案**：
1. 确保 `go.mod` 中使用 `go.noahlan.cn/nnet`
2. 确保代码中的导入也使用 `go.noahlan.cn/nnet`
3. 重新运行 `go mod tidy`
### 7.3 私有仓库访问
如果 Git 仓库是私有的，需要配置 Git 凭据：
```bash
# 配置 Git 凭据
git config --global credential.helper store
# 或者在 URL 中包含 token
# https://username:token@github.com/yourusername/nnet.git
```
## 八、最佳实践
### 8.1 仓库同步
确保所有仓库（GitHub、Gitee、私有库）的代码和标签保持同步：
```bash
# 使用提供的脚本
./scripts/push-all.sh
```
### 8.2 版本管理
- 使用语义化版本（Semantic Versioning）
- 每个版本创建对应的 Git 标签
- 在主仓库（GitHub）发布 Release
### 8.3 文档更新
- 在 README 中说明模块路径
- 更新所有示例代码使用新路径
- 在文档中说明域名配置
## 九、配置检查清单
- [ ] DNS 记录已配置（go.noahlan.cn 指向正确服务器）
- [ ] HTTP 服务已配置（返回正确的 go-import meta 标签）
- [ ] Git 仓库已创建（GitHub、Gitee等）
- [ ] go.mod 文件已更新（使用 go.noahlan.cn/nnet）
- [ ] 版本标签已创建并推送
- [ ] 测试模块获取成功
- [ ] 文档已更新
## 十、参考资源
- [Go Modules 官方文档](https://go.dev/ref/mod)
- [gopkg.in 服务](https://gopkg.in)
- [自定义导入路径](https://go.dev/cmd/go/#hdr-Remote_import_paths)
---
**文档版本**: v1.0
**最后更新**: 2024
**域名**: go.noahlan.cn