wangjia
6e2657049e
Introduces the frozen control-plane ↔ agent gRPC contract and the full buf v2 code-generation pipeline that task #6/#14/#15 depend on. Changes: - server/proto/pangolin/agent/v1/agent.proto: AgentService with 6 RPCs (Enroll, Register, Heartbeat, Subscribe, Ack, ReportUsage) and all supporting message types (Command + 5 payload variants, ConfigSnapshot, CredentialEntry, NodeLoad, UsageItem). Red-line comments prohibit user_id/email and destination-address fields per privacy policy. - server/buf.yaml: v2 format, STANDARD lint + FILE breaking rules. - server/buf.gen.yaml: remote protoc-gen-go v1.36.4 + protoc-gen-go-grpc v1.5.1 plugins, out=internal/pb, paths=source_relative. - server/internal/pb/pangolin/agent/v1/: generated agent.pb.go + agent_grpc.pb.go committed to repo (CI diff-clean verified). - server/Makefile: proto / proto-lint / proto-breaking targets added. - server/tools.go: buf v1.70.0, protoc-gen-go, protoc-gen-go-grpc pinned. - server/go.mod / go.sum: buf and grpc tool deps added via go mod tidy. Acceptance verified: buf lint → zero warnings buf generate × 2 → git diff clean (idempotent) go build ./... → passes Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Pangolin
面向中国大陆用户的终端 VPN(科学上网)项目。
- 设计方案:
docs/技术方案.md - 实施计划:
plan/ - 部署(Phase 0,容器化 + CI/CD):
deploy/
Phase 0 现状
数据面两条线,容器化、经 Gitea Actions 自动部署到节点,与现网服务隔离:
- Xray VLESS + REALITY(主线,经宿主 nginx SNI 分流)
- sing-box Hysteria2(晚高峰加速线,UDP 443)
部署细节见 deploy/README.md。