From 891cb7b9c192acb9f36d628c900d04b10872d13b Mon Sep 17 00:00:00 2001 From: ryan Date: Thu, 19 Mar 2026 09:28:57 +0800 Subject: [PATCH] =?UTF-8?q?[=E4=BC=98=E5=8C=96]=20=E6=9B=B4=E6=96=B0=20swa?= =?UTF-8?q?ggo/swag=20=E4=BE=9D=E8=B5=96=E7=89=88=E6=9C=AC=E8=87=B3=20v1.1?= =?UTF-8?q?6.4=EF=BC=8C=E5=B9=B6=E6=9B=B4=E6=96=B0=E6=96=87=E6=A1=A3?= =?UTF-8?q?=E7=94=9F=E6=88=90=E6=8C=87=E4=BB=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 3 +++ docs/deployment.md | 2 +- openflare_server/go.mod | 2 +- openflare_server/go.sum | 4 ++-- 4 files changed, 7 insertions(+), 4 deletions(-) diff --git a/README.md b/README.md index fc6e19b7..1dcdaeb6 100644 --- a/README.md +++ b/README.md @@ -226,6 +226,9 @@ go run ./cmd/agent -config /path/to/agent.json 登录管理端后，可访问 Swagger UI：`/swagger/index.html` +如需重新生成 Swagger 文档，请使用与服务端依赖一致的版本： +`go install github.com/swaggo/swag/cmd/swag@v1.16.4` + ## 开源协议 本项目采用 [Apache License 2.0](./LICENSE) 开源。 diff --git a/docs/deployment.md b/docs/deployment.md index 936535d0..2e8dd064 100644 --- a/docs/deployment.md +++ b/docs/deployment.md @@ -107,7 +107,7 @@ docker compose up -d 如需在本地重新生成文档： ```bash -go install github.com/swaggo/swag/cmd/swag@latest +go install github.com/swaggo/swag/cmd/swag@v1.16.4 cd openflare_server swag init -g main.go -o docs ``` diff --git a/openflare_server/go.mod b/openflare_server/go.mod index 11e359a3..459f83f5 100644 --- a/openflare_server/go.mod +++ b/openflare_server/go.mod @@ -16,7 +16,7 @@ require ( github.com/oschwald/maxminddb-golang v1.13.1 github.com/swaggo/files v1.0.1 github.com/swaggo/gin-swagger v1.6.1 - github.com/swaggo/swag v1.8.12 + github.com/swaggo/swag v1.16.4 golang.org/x/crypto v0.45.0 golang.org/x/net v0.47.0 gorm.io/driver/postgres v1.6.0 diff --git a/openflare_server/go.sum b/openflare_server/go.sum index 81ade530..d97b8d63 100644 --- a/openflare_server/go.sum +++ b/openflare_server/go.sum @@ -174,8 +174,8 @@ github.com/swaggo/files v1.0.1 h1:J1bVJ4XHZNq0I46UU90611i9/YzdrF7x92oX1ig5IdE= github.com/swaggo/files v1.0.1/go.mod h1:0qXmMNH6sXNf+73t65aKeB+ApmgxdnkQzVTAj2uaMUg= github.com/swaggo/gin-swagger v1.6.1 h1:Ri06G4gc9N4t4k8hekMigJ9zKTFSlqj/9paAQCQs7cY= github.com/swaggo/gin-swagger v1.6.1/go.mod h1:LQ+hJStHakCWRiK/YNYtJOu4mR2FP+pxLnILT/qNiTw= -github.com/swaggo/swag v1.8.12 h1:pctzkNPu0AlQP2royqX3apjKCQonAnf7KGoxeO4y64w= -github.com/swaggo/swag v1.8.12/go.mod h1:lNfm6Gg+oAq3zRJQNEMBE66LIJKM44mxFqhEEgy2its= +github.com/swaggo/swag v1.16.4 h1:clWJtd9LStiG3VeijiCfOVODP6VpHtKdQy9ELFG3s1A= +github.com/swaggo/swag v1.16.4/go.mod h1:VBsHJRsDvfYvqoiMKnsdwhNV9LEMHgEDZcyVYX0sxPg= github.com/twitchyliquid64/golang-asm v0.15.1 h1:SU5vSMR7hnwNxj24w34ZyCi/FmDZTkS4MhqMhdFk5YI= github.com/twitchyliquid64/golang-asm v0.15.1/go.mod h1:a1lVb/DtPvCB8fslRZhAngC2+aY1QWCk3Cedj/Gdt08= github.com/ugorji/go v1.1.7/go.mod h1:kZn38zHttfInRq0xu/PH0az30d+z6vm202qpg1oXVMw=