From b491d8af32bc03474ea5f23a37bd26b60b923677 Mon Sep 17 00:00:00 2001 From: Wang Defa Date: Thu, 25 Dec 2025 10:55:04 +0800 Subject: [PATCH] =?UTF-8?q?ci:=20=E7=BB=9F=E4=B8=80=20Debian=20=E5=8F=91?= =?UTF-8?q?=E5=B8=83=E4=B8=BA=20stable=20=E5=8F=91=E8=A1=8C=E7=89=88?= =?UTF-8?q?=E5=B9=B6=E6=9B=B4=E6=96=B0=E7=9B=B8=E5=85=B3=E6=96=87=E6=A1=A3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 去除多发行版支持（bookworm、trixie），改为 stable 单一发行版 - 更新 CI 配置：Debian 包统一上传到 debian/pool/stable/main - 简化 Release 说明生成脚本 - 更新安装指南、发布指南和 CI/CD 架构文档 - 补充系统设计和配置参考文档 --- .gitea/workflows/ci.yaml | 22 ++++--------- README.md | 36 +++++---------------- llmdoc/architecture/cicd-pipeline.md | 8 ++--- llmdoc/architecture/system-design.md | 29 +++++++++++++++++ llmdoc/guides/how-to-install.md | 23 ++----------- llmdoc/guides/how-to-release.md | 18 +++++------ llmdoc/index.md | 29 +++++++++-------- llmdoc/overview/project-overview.md | 23 ++++++++----- llmdoc/reference/configuration-reference.md | 24 ++++++++++++++ 9 files changed, 112 insertions(+), 100 deletions(-) create mode 100644 llmdoc/architecture/system-design.md create mode 100644 llmdoc/reference/configuration-reference.md diff --git a/.gitea/workflows/ci.yaml b/.gitea/workflows/ci.yaml index 1d8a968..1828b32 100644 --- a/.gitea/workflows/ci.yaml +++ b/.gitea/workflows/ci.yaml @@ -130,29 +130,19 @@ jobs: } done - # 上传 Debian 包到 Debian Package Registry (支持多个发行版) + # 上传 Debian 包到 Debian Package Registry (通用稳定版) echo "" echo "📦 上传 Debian 包到 Debian Package Registry..." for file in *.deb; do [ ! -f "$file" ] && continue - # 上传到 bookworm (Debian 12) - echo " ⬆️ $file → bookworm" + # 上传到 stable (通用稳定版) + echo " ⬆️ $file → stable" curl -fsSL -X PUT \ -H "Authorization: token ${TOKEN}" \ --upload-file "$file" \ - "https://${REGISTRY}/api/packages/${OWNER}/debian/pool/bookworm/main/upload" || { - echo "❌ Debian 包上传失败: $file (bookworm)" - exit 1 - } - - # 上传到 trixie (Debian 13) - echo " ⬆️ $file → trixie" - curl -fsSL -X PUT \ - -H "Authorization: token ${TOKEN}" \ - --upload-file "$file" \ - "https://${REGISTRY}/api/packages/${OWNER}/debian/pool/trixie/main/upload" || { - echo "❌ Debian 包上传失败: $file (trixie)" + "https://${REGISTRY}/api/packages/${OWNER}/debian/pool/stable/main/upload" || { + echo "❌ Debian 包上传失败: $file (stable)" exit 1 } done @@ -162,7 +152,7 @@ jobs: echo "📝 生成 Release..." export REGISTRY OWNER TAG - RELEASE_DATA=$(python3 -c 'import json,glob,os;r=os.environ["REGISTRY"];o=os.environ["OWNER"];p=os.environ["PRODUCT_NAME"];t=os.environ["TAG"];b=["## Release "+t,"","Mond 是 Monero 守护进程 (monerod) 的定制版本。","","### ✨ 主要特性","","- 🔗 **纯静态链接** - 无需依赖，可在任意 Linux 系统运行","- 🏗️ **多架构支持** - 原生支持 AMD64 和 ARM64","- 📦 **官方构建系统** - 使用 Monero 官方 depends 系统构建，确保可靠性","","### 📥 下载方式","","#### 方式一：直接下载（推荐）","","点击下方 **Assets** 区域的文件名直接下载。","","**可用安装包：**",""]+[f"- [`{f}`](https://{r}/api/packages/{o}/generic/{p}/{t}/{f})" for f in sorted(glob.glob("*.tar.gz"))]+["","#### 方式二：通用软件包仓库","","通过命令行下载：",""]+[f"```bash\nwget https://{r}/api/packages/{o}/generic/{p}/{t}/{f}\n```" for f in sorted(glob.glob("*.tar.gz"))[:1]]+["","#### 方式三：Debian 软件源","","**Debian 12 (Bookworm)：**","","```bash","# 下载 GPG 密钥",f"sudo curl https://{r}/api/packages/{o}/debian/repository.key -o /etc/apt/keyrings/gitea-{o}.asc","","# 添加软件源",f"echo \"deb [signed-by=/etc/apt/keyrings/gitea-{o}.asc] https://{r}/api/packages/{o}/debian bookworm main\" | sudo tee -a /etc/apt/sources.list.d/{o}.list","","# 更新并安装","sudo apt-get update","sudo apt-get install mond","```","","**Debian 13 (Trixie)：**","","```bash","# 下载 GPG 密钥",f"sudo curl https://{r}/api/packages/{o}/debian/repository.key -o /etc/apt/keyrings/gitea-{o}.asc","","# 添加软件源",f"echo \"deb [signed-by=/etc/apt/keyrings/gitea-{o}.asc] https://{r}/api/packages/{o}/debian trixie main\" | sudo tee -a /etc/apt/sources.list.d/{o}.list","","# 更新并安装","sudo apt-get update","sudo apt-get install mond","```"];print(json.dumps({"tag_name":t,"name":f"Release {t}","body":"\n".join(b),"draft":False,"prerelease":False}))') + RELEASE_DATA=$(python3 -c 'import json,glob,os;r=os.environ["REGISTRY"];o=os.environ["OWNER"];p=os.environ["PRODUCT_NAME"];t=os.environ["TAG"];b=["## Release "+t,"","Mond 是 Monero 守护进程 (monerod) 的定制版本。","","### ✨ 主要特性","","- 🔗 **纯静态链接** - 无需依赖，可在任意 Linux 系统运行","- 🏗️ **多架构支持** - 原生支持 AMD64 和 ARM64","- 📦 **官方构建系统** - 使用 Monero 官方 depends 系统构建，确保可靠性","","### 📥 下载方式","","#### 方式一：直接下载（推荐）","","点击下方 **Assets** 区域的文件名直接下载。","","**可用安装包：**",""]+[f"- [`{f}`](https://{r}/api/packages/{o}/generic/{p}/{t}/{f})" for f in sorted(glob.glob("*.tar.gz"))]+["","#### 方式二：通用软件包仓库","","通过命令行下载：",""]+[f"```bash\nwget https://{r}/api/packages/{o}/generic/{p}/{t}/{f}\n```" for f in sorted(glob.glob("*.tar.gz"))[:1]]+["","#### 方式三：Debian 软件源","","```bash","# 下载 GPG 密钥",f"sudo curl https://{r}/api/packages/{o}/debian/repository.key -o /etc/apt/keyrings/gitea-{o}.asc","","# 添加软件源",f"echo \"deb [signed-by=/etc/apt/keyrings/gitea-{o}.asc] https://{r}/api/packages/{o}/debian stable main\" | sudo tee -a /etc/apt/sources.list.d/{o}.list","","# 更新并安装","sudo apt-get update","sudo apt-get install mond","```"];print(json.dumps({"tag_name":t,"name":f"Release {t}","body":"\n".join(b),"draft":False,"prerelease":False}))') # 创建 Release echo "" diff --git a/README.md b/README.md index 0bfc591..e446117 100644 --- a/README.md +++ b/README.md @@ -16,36 +16,16 @@ ## 🚀 快速开始 -### 方式一：Debian/Ubuntu（推荐） - -#### Debian 12 (Bookworm) +### Debian/Ubuntu（推荐） ```bash -# 1. 下载并添加 GPG 密钥 -sudo curl https://gitea.bcde.io/api/packages/wangdefa/debian/repository.key \ - -o /etc/apt/keyrings/gitea-wangdefa.asc +# 下载 GPG 密钥 +sudo curl https://gitea.bcde.io/api/packages/wangdefa/debian/repository.key -o /etc/apt/keyrings/gitea-wangdefa.asc -# 2. 添加软件源 -echo "deb [signed-by=/etc/apt/keyrings/gitea-wangdefa.asc] https://gitea.bcde.io/api/packages/wangdefa/debian bookworm main" | \ - sudo tee -a /etc/apt/sources.list.d/wangdefa.list +# 添加仓库 +echo "deb [signed-by=/etc/apt/keyrings/gitea-wangdefa.asc] https://gitea.bcde.io/api/packages/wangdefa/debian stable main" | sudo tee -a /etc/apt/sources.list.d/wangdefa.list -# 3. 安装 -sudo apt-get update -sudo apt-get install mond -``` - -#### Debian 13 (Trixie) - -```bash -# 1. 下载并添加 GPG 密钥 -sudo curl https://gitea.bcde.io/api/packages/wangdefa/debian/repository.key \ - -o /etc/apt/keyrings/gitea-wangdefa.asc - -# 2. 添加软件源 -echo "deb [signed-by=/etc/apt/keyrings/gitea-wangdefa.asc] https://gitea.bcde.io/api/packages/wangdefa/debian trixie main" | \ - sudo tee -a /etc/apt/sources.list.d/wangdefa.list - -# 3. 安装 +# 更新并安装 sudo apt-get update sudo apt-get install mond ``` @@ -54,10 +34,10 @@ sudo apt-get install mond ```bash # 1. 下载对应架构的包 -wget https://gitea.bcde.io/releases/download/VERSION/mond-amd64-ubuntu-VERSION.tar.gz +wget https://gitea.bcde.io/releases/download/v0.18.4.4/mond-amd64-ubuntu-v0.18.4.4.tar.gz # 2. 解压 -tar -xzf mond-amd64-ubuntu-VERSION.tar.gz +tar -xzf mond-amd64-ubuntu-v0.18.4.4.tar.gz # 3. 运行 ./mond --help diff --git a/llmdoc/architecture/cicd-pipeline.md b/llmdoc/architecture/cicd-pipeline.md index 21f3a13..9659da2 100644 --- a/llmdoc/architecture/cicd-pipeline.md +++ b/llmdoc/architecture/cicd-pipeline.md @@ -27,12 +27,12 @@ ### 发布流程 1. **标签创建：** 手动或自动创建语义化版本标签 2. **构建制品：** - - 多架构 Docker 镜像 - - Debian 包 + - 多架构 Debian 包（amd64, arm64） - 二进制可执行文件 3. **发布到：** - - GitHub/Gitea Release - - 包管理仓库 + - Gitea Release（附件形式） + - Generic Package Registry（通用软件包仓库） + - Debian Package Registry（stable 发行版） ## 4. 设计原理 diff --git a/llmdoc/architecture/system-design.md b/llmdoc/architecture/system-design.md new file mode 100644 index 0000000..4f155b8 --- /dev/null +++ b/llmdoc/architecture/system-design.md @@ -0,0 +1,29 @@ +# Mond 架构设计 + +## 1. 组件概览 + +- 主守护进程二进制文件 +- 项目初始化和定制脚本 +- 多架构构建配置 + +## 2. 核心文件类型 + +- 源代码文件 +- 构建脚本 +- Docker 构建配置 +- CMake 配置文件 + +## 3. 构建流程 + +1. **源代码准备**：克隆 Monero 源代码 +2. **定制应用**：替换 Monero 特定标识符 +3. **依赖构建**：使用 Monero 的 depends 系统 +4. **编译**：使用 CMake 和 Make 构建 +5. **打包**：生成多架构二进制和 Debian 包 + +## 4. 关键设计决策 + +- 使用纯静态链接以提高可移植性 +- 支持多架构（AMD64、ARM64） +- 保留原始 Monero 核心功能 +- 简化安装和配置过程 diff --git a/llmdoc/guides/how-to-install.md b/llmdoc/guides/how-to-install.md index d72e0e5..6547497 100644 --- a/llmdoc/guides/how-to-install.md +++ b/llmdoc/guides/how-to-install.md @@ -3,38 +3,19 @@ ## 支持的平台 Mond 支持以下平台和安装方式： -- Debian 12 (Bookworm) -- Debian 13 (Trixie) +- Debian stable - Ubuntu 最新 LTS 版本 - 通用 Linux 二进制包（支持 AMD64 和 ARM64） ## 方式一：Debian/Ubuntu 安装（推荐） -### Debian 12 (Bookworm) - ```bash # 1. 下载并添加 GPG 密钥 sudo curl https://gitea.bcde.io/api/packages/wangdefa/debian/repository.key \ -o /etc/apt/keyrings/gitea-wangdefa.asc # 2. 添加软件源 -echo "deb [signed-by=/etc/apt/keyrings/gitea-wangdefa.asc] https://gitea.bcde.io/api/packages/wangdefa/debian bookworm main" | \ - sudo tee -a /etc/apt/sources.list.d/wangdefa.list - -# 3. 安装 -sudo apt-get update -sudo apt-get install mond -``` - -### Debian 13 (Trixie) - -```bash -# 1. 下载并添加 GPG 密钥 -sudo curl https://gitea.bcde.io/api/packages/wangdefa/debian/repository.key \ - -o /etc/apt/keyrings/gitea-wangdefa.asc - -# 2. 添加软件源 -echo "deb [signed-by=/etc/apt/keyrings/gitea-wangdefa.asc] https://gitea.bcde.io/api/packages/wangdefa/debian trixie main" | \ +echo "deb [signed-by=/etc/apt/keyrings/gitea-wangdefa.asc] https://gitea.bcde.io/api/packages/wangdefa/debian stable main" | \ sudo tee -a /etc/apt/sources.list.d/wangdefa.list # 3. 安装 diff --git a/llmdoc/guides/how-to-release.md b/llmdoc/guides/how-to-release.md index e89c5ae..8143583 100644 --- a/llmdoc/guides/how-to-release.md +++ b/llmdoc/guides/how-to-release.md @@ -38,17 +38,17 @@ git push origin v1.2.3 ## 4. 包管理仓库上传 ### 自动上传 -- CI 流水线将自动处理 -- 触发条件：新的版本标签推送 +CI 流水线将自动上传到以下位置： +- **Generic Package Registry**：通用软件包仓库 +- **Debian Package Registry**：stable 发行版 -### 手动上传（备选） -```bash -# 构建 Debian 包 -./debian/build-deb.sh +触发条件：新的版本标签推送 -# 上传到包仓库 -dput ppa:your-ppa-name/mond mond_1.2.3_amd64.changes -``` +### 上传目标 +所有 Debian 包统一上传到： +- 发行版：stable +- 组件：main +- 路径：`debian/pool/stable/main` ## 5. 发布后验证 diff --git a/llmdoc/index.md b/llmdoc/index.md index 86e1a96..58592ea 100644 --- a/llmdoc/index.md +++ b/llmdoc/index.md @@ -1,20 +1,21 @@ -# Mond 项目文档 +# Mond 文档 -## 概述 -Mond 是一个基于 Monero 的区块链项目，专注于隐私和去中心化。 +## 概览 -## 文档导航 +[项目概述](/overview/project-overview.md) -### 项目概览 -- [项目背景](/overview/project-overview.md) -- [系统配置参考](/reference/configuration.md) +## 指南 -### 构建指南 -- [如何构建项目](/guides/how-to-build.md) +- [安装指南](/guides/installation.md) -### 架构 -- [构建系统](/architecture/build-system.md) +## 架构 -### 参考 -- [常见问题](/reference/faq.md) -- [配置文件详解](/reference/configuration.md) \ No newline at end of file +- [系统设计](/architecture/system-design.md) + +## 参考资料 + +- [配置参考](/reference/configuration-reference.md) + +## 许可证 + +本文档遵循 BSD-3-Clause 许可证，与 Mond 项目保持一致。 diff --git a/llmdoc/overview/project-overview.md b/llmdoc/overview/project-overview.md index 074266d..b649713 100644 --- a/llmdoc/overview/project-overview.md +++ b/llmdoc/overview/project-overview.md @@ -1,12 +1,19 @@ -# Mond 项目概览 +# Mond: Monero Daemon 定制版 -## 1. 项目定位 +## 1. 身份 -Mond 是一个基于 Monero 区块链技术的开源项目，专注于提供更加安全、私密的去中心化交易解决方案。 +- **定义**：Monero 守护进程的定制开源实现 +- **目的**：提供高度可移植、易于部署的 Monero 节点解决方案 -## 2. 核心特点 +## 2. 高级描述 -- 高度私密的交易机制 -- 基于 Monero 核心技术 -- 跨平台支持（Ubuntu, Alpine Linux, amd64/arm64） -- 灵活的构建系统 +Mond 是基于 Monero 项目的定制守护进程实现，专注于多架构支持、简化部署和增强可移植性。通过纯静态链接和多种安装方式，Mond 为不同 Linux 环境中运行 Monero 节点提供了灵活的选择。 + +## 3. 关键特性 + +- 多架构支持（AMD64、ARM64） +- 多发行版兼容（Ubuntu、Debian） +- 纯静态链接 +- 灵活的安装和配置选项 +- 隐私保护 +- 自动更新支持 diff --git a/llmdoc/reference/configuration-reference.md b/llmdoc/reference/configuration-reference.md new file mode 100644 index 0000000..5687de8 --- /dev/null +++ b/llmdoc/reference/configuration-reference.md @@ -0,0 +1,24 @@ +# Mond 参考信息 + +## 核心摘要 + +Mond 是 Monero 守护进程的定制开源实现，提供高度可配置和可移植的 Monero 节点解决方案。 + +## 关键信息源 + +- **源代码库**：https://github.com/monero-project/monero +- **官方网站**：未定义（本项目为定制版） +- **授权协议**：BSD-3-Clause + +## 配置选项参考 + +### 常用命令行参数 + +- `--data-dir `：指定数据目录 +- `--log-file `：指定日志文件路径 +- `--log-level `：日志级别（0-4） +- `--detach`：后台运行 +- `--rpc-bind-ip `：RPC 绑定 IP +- `--rpc-bind-port `：RPC 绑定端口 +- `--p2p-bind-ip `：P2P 绑定 IP +- `--p2p-bind-port `：P2P 绑定端口