Add verifiable documentation and release assets

Author: VPNDevelop

.github/workflows/container.yml

@@ -0,0 +1,53 @@
+name: Container
+
+on:
+  push:
+    tags:
+      - "v*"
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  publish:
+    runs-on: ubuntu-24.04
+    permissions:
+      attestations: write
+      contents: read
+      id-token: write
+      packages: write
+    steps:
+      - name: Checkout
+        uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262 # v4
+      - name: Log in to GitHub Container Registry
+        uses: docker/login-action@c94ce9fb468520275223c153574b00df6fe4bcc9 # v3
+        with:
+          registry: ghcr.io
+          username: ${{ github.actor }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+      - name: Extract metadata
+        id: meta
+        uses: docker/metadata-action@c299e40c65443455700f0fdfc63efafe5b349051 # v5
+        with:
+          images: ghcr.io/vpndevelop/singlink-control-plane-demo
+          tags: |
+            type=semver,pattern={{version}}
+            type=semver,pattern={{major}}.{{minor}}
+            type=sha
+      - name: Build and publish
+        id: push
+        uses: docker/build-push-action@10e90e3645eae34f1e60eeb005ba3a3d33f178e8 # v6
+        with:
+          context: .
+          push: true
+          tags: ${{ steps.meta.outputs.tags }}
+          labels: ${{ steps.meta.outputs.labels }}
+          provenance: mode=max
+          sbom: true
+      - name: Attest build provenance
+        uses: actions/attest@36051bcae73b7c2a8a6945a48cbf80953c6baa35 # v4
+        with:
+          subject-name: ghcr.io/vpndevelop/singlink-control-plane-demo
+          subject-digest: ${{ steps.push.outputs.digest }}
+          push-to-registry: true

.github/workflows/pages.yml

@@ -0,0 +1,41 @@
+name: Documentation
+
+on:
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+concurrency:
+  group: pages
+  cancel-in-progress: false
+
+jobs:
+  build:
+    runs-on: ubuntu-24.04
+    steps:
+      - name: Checkout
+        uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262 # v4
+      - name: Configure Pages
+        uses: actions/configure-pages@983d7736d9b0ae728b81ab479565c72886d7745b # v5
+      - name: Build with Jekyll
+        uses: actions/jekyll-build-pages@44a6e6beabd48582f863aeeb6cb2151cc1716697 # v1
+        with:
+          source: ./docs
+          destination: ./_site
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@7b1f4a764d45c48632c6b24a0339c27f5614fb0b # v4
+
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-24.04
+    needs: build
+    permissions:
+      pages: write
+      id-token: write
+    steps:
+      - name: Deploy Pages
+        id: deployment
+        uses: actions/deploy-pages@d6db90164ac5ed86f2b6aed7e0febac5b3c0c03e # v4

CITATION.cff

@@ -0,0 +1,20 @@
+cff-version: 1.2.0
+message: "如果本项目对您的研究、文章或产品设计有帮助，请引用此仓库。"
+title: "如何开发一个 VPN 软件：SingLink 架构与开源参考实现"
+type: software
+authors:
+  - name: VPNDevelop
+    website: "https://vpndevelop.com/"
+repository-code: "https://github.com/VPNDevelop/vpn-development-guide"
+url: "https://vpndevelop.com/open-source"
+license: Apache-2.0
+version: 0.1.0
+keywords:
+  - VPN 软件开发
+  - SingLink
+  - VPN control plane
+  - VPN client
+  - node management
+abstract: >-
+  面向中文开发者的 VPN 软件架构教程和可运行控制平面参考实现，
+  涵盖客户端、控制平面、节点、安全测试与发布流程。

README.md

@@ -1,6 +1,6 @@
 # 如何开发一个 VPN 软件
 
-[English summary](README.en.md) · [开发路线图](ROADMAP.md) · [安全政策](SECURITY.md) · [VPNDevelop](https://vpndevelop.com/)
+[English summary](README.en.md) · [开发路线图](ROADMAP.md) · [安全政策](SECURITY.md) · [引用本项目](CITATION.cff) · [VPNDevelop](https://vpndevelop.com/)
 
 这是一个以简体中文为主、持续维护的 VPN 软件开发教程与开源参考实现。项目从产品架构、协议选择、控制平面、节点管理、客户端接入、安全测试到应用商店上架，说明一个 VPN 产品如何从概念走到可验证交付。
 
@@ -75,6 +75,15 @@ deploy/                  本地 Docker 示例
 
 欢迎提交文档修正、测试、平台兼容建议和经过验证的实现。提交前请阅读 [贡献指南](CONTRIBUTING.md)。安全问题请不要创建公开 Issue，请按 [安全政策](SECURITY.md) 联系 `support@vpndevelop.com`。
 
+## 第三方可验证资产
+
+- GitHub Pages 技术文档由本仓库 `docs/` 自动构建，不维护隐藏副本。
+- Postman Collection 位于 [`postman/`](postman/)，默认只访问本机教学服务。
+- 带 `v` 的版本标签会构建 `ghcr.io/vpndevelop/singlink-control-plane-demo`，并附带来源证明和 SBOM。
+- 所有镜像站与内容分发必须遵守[开源发布与安全边界](docs/PUBLICATION_BOUNDARIES.md)。
+
+发布后，GitHub 仓库仍是代码、版本和安全政策的唯一上游来源。
+
 ## 商业开发
 
 如需完整 VPN 客户端、节点系统、协议集成、源码交付、贴牌或应用商店上架服务，请访问：

docs/PUBLICATION_BOUNDARIES.md

@@ -0,0 +1,37 @@
+---
+layout: default
+title: 开源发布与安全边界
+description: VPNDevelop 示例代码、容器镜像、API 文档和第三方镜像站的公开边界。
+---
+
+# 开源发布与安全边界
+
+本仓库公开的是通用工程方法、教学代码和模拟数据。任何第三方镜像、文档站、容器或 API Collection 都必须遵守同一边界。
+
+## 可以公开
+
+- 不包含真实账号的接口结构和模拟响应
+- 仅在内存中运行的教学型控制平面
+- 架构边界、测试方法和发布检查清单
+- 由公开仓库同一提交构建的不可变版本
+
+## 不得公开
+
+- 生产节点地址、服务器清单、私钥、令牌和环境变量
+- 客户名称、用户标识、订阅、支付和真实流量数据
+- SingLink 商业系统源码、调度策略和反滥用规则
+- 未修复漏洞的利用细节
+- 可绕过平台审核、网络策略或法律要求的实现
+
+## 第三方发布要求
+
+1. Docker/OCI 镜像必须由 GitHub Actions 从公开提交构建，不从开发者电脑手工上传。
+2. 镜像标签必须包含版本号；生产用途不得使用 `latest` 作为唯一依据。
+3. Postman 示例只能使用 `127.0.0.1` 和模拟变量，禁止提交真实 Token。
+4. Gitee 等镜像站必须注明 GitHub 是上游来源，并保留许可证与安全政策。
+5. 文档站只发布仓库内容，不注入统计密钥、客户脚本或生产配置。
+6. 发布前必须完成 secret scan、单元测试、镜像健康检查和文件差异复核。
+
+## 漏洞报告
+
+请遵循仓库的 [安全政策](https://github.com/VPNDevelop/vpn-development-guide/security/policy)。不要在 Issue、Discussion 或公开评论中粘贴敏感信息。

docs/_config.yml

@@ -0,0 +1,9 @@
+title: VPNDevelop 开发指南
+description: 中文 VPN 软件开发教程、SingLink 架构与开源参考实现
+lang: zh-CN
+url: https://vpndevelop.github.io
+baseurl: /vpn-development-guide
+repository: VPNDevelop/vpn-development-guide
+theme: jekyll-theme-minimal
+plugins:
+  - jekyll-seo-tag

docs/index.md

@@ -0,0 +1,32 @@
+---
+layout: default
+title: 如何开发一个 VPN 软件
+description: 中文 VPN 软件开发教程，介绍 SingLink 模块化架构、客户端、控制平面、节点、安全与上架流程。
+---
+
+# 如何开发一个 VPN 软件
+
+本技术文档以简体中文说明 VPN 产品从架构设计到可验证交付的主要工程环节，并提供一个可运行的教学型控制平面。
+
+> 本项目用于教学和架构参考，不是可直接承载真实用户流量的商业 VPN 系统。
+
+## 阅读路线
+
+1. [VPN 软件整体架构](01-vpn-architecture.md)
+2. [SingLink 模块化架构](02-singlink-architecture.md)
+3. [VPN 客户端开发](03-client-development.md)
+4. [控制平面与配置下发](04-control-plane.md)
+5. [VPN 节点部署与运行](05-node-deployment.md)
+6. [密钥管理与安全边界](06-key-management.md)
+7. [日志、隐私与可观测性](07-logging-and-privacy.md)
+8. [应用商店上架](08-app-store-release.md)
+9. [安全测试与发布验收](09-security-testing.md)
+
+## 可验证资源
+
+- [源代码与版本记录](https://github.com/VPNDevelop/vpn-development-guide)
+- [公开边界说明](PUBLICATION_BOUNDARIES.md)
+- [Postman API 示例](https://github.com/VPNDevelop/vpn-development-guide/blob/main/postman/VPNDevelop-SingLink-Control-Plane.postman_collection.json)
+- [VPNDevelop 开源项目页](https://vpndevelop.com/open-source)
+
+安全问题请按[安全政策](https://github.com/VPNDevelop/vpn-development-guide/security/policy)联系维护者，不要创建公开 Issue。

postman/VPNDevelop-SingLink-Control-Plane.postman_collection.json

@@ -0,0 +1,66 @@
+{
+  "info": {
+    "_postman_id": "4a7a5af2-07d8-4f37-b3b0-68bb2c90ee25",
+    "name": "VPNDevelop SingLink Control Plane Demo",
+    "description": "教学型控制平面 API。默认只访问本机，不含生产地址、凭据或真实数据。",
+    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
+  },
+  "variable": [
+    {
+      "key": "baseUrl",
+      "value": "http://127.0.0.1:8080",
+      "type": "string"
+    }
+  ],
+  "item": [
+    {
+      "name": "健康检查",
+      "request": {
+        "method": "GET",
+        "header": [],
+        "url": {
+          "raw": "{{baseUrl}}/healthz",
+          "host": ["{{baseUrl}}"],
+          "path": ["healthz"]
+        },
+        "description": "确认教学服务正在运行。"
+      },
+      "event": [
+        {
+          "listen": "test",
+          "script": {
+            "type": "text/javascript",
+            "exec": [
+              "pm.test('HTTP 200', function () { pm.response.to.have.status(200); });",
+              "pm.test('返回健康状态', function () { pm.expect(pm.response.json().status).to.eql('ok'); });"
+            ]
+          }
+        }
+      ]
+    },
+    {
+      "name": "节点列表",
+      "request": {
+        "method": "GET",
+        "header": [],
+        "url": {
+          "raw": "{{baseUrl}}/v1/nodes",
+          "host": ["{{baseUrl}}"],
+          "path": ["v1", "nodes"]
+        },
+        "description": "读取内存中的教学节点列表；重启服务后数据会清空。"
+      },
+      "event": [
+        {
+          "listen": "test",
+          "script": {
+            "type": "text/javascript",
+            "exec": [
+              "pm.test('HTTP 200', function () { pm.response.to.have.status(200); });"
+            ]
+          }
+        }
+      ]
+    }
+  ]
+}