本文介绍在 go 文档服务器（godoc）中彻底隐藏源码链接与访问路径的实用方案，重点推荐基于反向代理的权限控制方式，并提供可落地的 nginx 配置示例与注意事项。
本文介绍在 go 文档服务器（godoc）中彻底隐藏源码链接与访问路径的实用方案，重点推荐基于反向代理的权限控制方式，并提供可落地的 nginx 配置示例与注意事项。
Go 自带的 godoc 工具是构建内部文档站点的轻量级选择，但其默认行为会暴露 /src/ 路径下的完整源码——这对面向第三方共享文档的场景存在安全与合规风险。尽管早期版本（如 Go 1.3）支持 godoc -src=false 等参数，但需明确：这些标志仅影响命令行模式（-server=false）下的静态 HTML 输出，对 HTTP 服务模式（-http=:port）完全无效。服务器启动后，所有 /src/... 路径仍可被直接访问或通过类型跳转触发。
✅ 推荐方案：Nginx 反向代理 + 路径拦截（最稳健）
无需修改 godoc 源码或模板，也不依赖不稳定的手动渲染流程，只需在 godoc 前部署一层反向代理，精准拦截敏感路径：
# /etc/nginx/conf.d/godoc.conf
upstream godoc_backend {
server 127.0.0.1:6060; # godoc 默认端口
}
server {
listen 80;
server_name doc.internal;
# 允许正常文档访问（/pkg/, /cmd/, /ref/, /search 等）
location / {
proxy_pass http://godoc_backend;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
}
# ? 严格禁止 /src/ 路径访问（返回 403）
location ^~ /src/ {
return 403 "Source code access is disabled.";
}
# （可选）进一步限制其他敏感路径
location ^~ /play/ { return 403; }
location = /debug/ { return 403; }
}重启 Nginx 后，外部用户访问 http://doc.internal/src/fmt 将直接收到 403 Forbidden；而 /pkg/fmt 等文档页面照常工作，类型签名、函数说明、示例代码（非源文件）全部保留，且无任何源码链接残留。
⚠️ 注意事项与补充建议
-
内部团队仍需源码？ 可通过 IP 白名单或 Basic Auth 实现差异化控制：
location ^~ /src/ { satisfy any; allow 192.168.1.0/24; # 内网允许 deny all; auth_basic "Restricted"; auth_basic_user_file /etc/nginx/.godoc_htpasswd; } - 避免模板篡改陷阱：手动修改 godoc 的 HTML 模板（如移除 ）虽能隐藏链接，但无法阻止用户手动拼接 /src/ URL 访问——必须配合服务端路径拦截才真正安全。
- 升级提醒：现代 Go 版本（≥1.13）已弃用内置 godoc，推荐迁移到 pkg.go.dev 或开源替代品（如 golds），后者原生支持 --no-src 等更精细的配置选项。
-
验证有效性：部署后务必测试以下场景：
- 点击任意类型名（如 fmt.Printf）是否仍跳转到 /src/ → 应失效；
- 直接浏览器访问 http://your-docs/src/net/http → 应返回 403；
- 搜索 json.Marshal 并查看结果页 → 源码链接应消失或变为纯文本。
综上，反向代理路径拦截是最小侵入、最高可靠性的实践方案——它不依赖 godoc 内部实现细节，兼容所有 Go 版本，且便于审计与维护。对于需长期托管第三方文档的团队，这一步配置应作为标准安全基线纳入部署流程。
