wangdefa/mond
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 2 Wiki Activity

ci: 统一 Debian 发布为 stable 发行版并更新相关文档
All checks were successful
Build and Release Mond / build-and-test (arm64) (push) Successful in 2s
Details
Build and Release Mond / build-and-test (amd64) (push) Successful in 16s
Details
Build and Release Mond / release (push) Successful in 28s
Details

Browse Source 
- 去除多发行版支持（bookworm、trixie），改为 stable 单一发行版
- 更新 CI 配置：Debian 包统一上传到 debian/pool/stable/main
- 简化 Release 说明生成脚本
- 更新安装指南、发布指南和 CI/CD 架构文档
- 补充系统设计和配置参考文档
This commit is contained in:
Wang Defa
2025-12-25 10:55:04 +08:00
parent b13d06aae7
commit b491d8af32
9 changed files with 112 additions and 100 deletions
Download Patch File Download Diff File Expand all files Collapse all files

22
.gitea/workflows/ci.yaml
View File

@@ -130,29 +130,19 @@ jobs:
} }
done done
# 上传 Debian 包到 Debian Package Registry (支持多个发行版) # 上传 Debian 包到 Debian Package Registry (通用稳定版)
echo "" echo ""
echo "📦 上传 Debian 包到 Debian Package Registry..." echo "📦 上传 Debian 包到 Debian Package Registry..."
for file in *.deb; do for file in *.deb; do
[ ! -f "$file" ] && continue [ ! -f "$file" ] && continue
# 上传到 bookworm (Debian 12) # 上传到 stable (通用稳定版)
echo " ⬆️ $file → bookworm" echo " ⬆️ $file → stable"
curl -fsSL -X PUT \ curl -fsSL -X PUT \
-H "Authorization: token ${TOKEN}" \ -H "Authorization: token ${TOKEN}" \
--upload-file "$file" \ --upload-file "$file" \
"https://${REGISTRY}/api/packages/${OWNER}/debian/pool/bookworm/main/upload" || { "https://${REGISTRY}/api/packages/${OWNER}/debian/pool/stable/main/upload" || {
echo "❌ Debian 包上传失败: $file (bookworm)" echo "❌ Debian 包上传失败: $file (stable)"
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)"
exit 1 exit 1
} }
done done
@@ -162,7 +152,7 @@ jobs:
echo "📝 生成 Release..." echo "📝 生成 Release..."
export REGISTRY OWNER TAG 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 # 创建 Release
echo "" echo ""

36
README.md
View File

@@ -16,36 +16,16 @@
## 🚀 快速开始 ## 🚀 快速开始
### 方式一：Debian/Ubuntu（推荐） ### Debian/Ubuntu（推荐）
#### Debian 12 (Bookworm)
```bash ```bash
# 1. 下载并添加 GPG 密钥 # 下载 GPG 密钥
sudo curl https://gitea.bcde.io/api/packages/wangdefa/debian/repository.key \ sudo curl https://gitea.bcde.io/api/packages/wangdefa/debian/repository.key -o /etc/apt/keyrings/gitea-wangdefa.asc
-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" | \ 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
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 update
sudo apt-get install mond sudo apt-get install mond
``` ```
@@ -54,10 +34,10 @@ sudo apt-get install mond
```bash ```bash
# 1. 下载对应架构的包 # 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. 解压 # 2. 解压
tar -xzf mond-amd64-ubuntu-VERSION.tar.gz tar -xzf mond-amd64-ubuntu-v0.18.4.4.tar.gz
# 3. 运行 # 3. 运行
./mond --help ./mond --help

8
llmdoc/architecture/cicd-pipeline.md
View File

@@ -27,12 +27,12 @@
### 发布流程 ### 发布流程
1. **标签创建：** 手动或自动创建语义化版本标签 1. **标签创建：** 手动或自动创建语义化版本标签
2. **构建制品：** 2. **构建制品：**
- 多架构 Docker 镜像 - 多架构 Debian 包（amd64, arm64）
- Debian 包
- 二进制可执行文件 - 二进制可执行文件
3. **发布到：** 3. **发布到：**
- GitHub/Gitea Release - Gitea Release（附件形式）
- 包管理仓库 - Generic Package Registry（通用软件包仓库）
- Debian Package Registry（stable 发行版）
## 4. 设计原理 ## 4. 设计原理

29
llmdoc/architecture/system-design.md Normal file
View File

@@ -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 核心功能
- 简化安装和配置过程

23
llmdoc/guides/how-to-install.md
View File

@@ -3,38 +3,19 @@
## 支持的平台 ## 支持的平台
Mond 支持以下平台和安装方式： Mond 支持以下平台和安装方式：
- Debian 12 (Bookworm) - Debian stable
- Debian 13 (Trixie)
- Ubuntu 最新 LTS 版本 - Ubuntu 最新 LTS 版本
- 通用 Linux 二进制包（支持 AMD64 和 ARM64） - 通用 Linux 二进制包（支持 AMD64 和 ARM64）
## 方式一：Debian/Ubuntu 安装（推荐） ## 方式一：Debian/Ubuntu 安装（推荐）
### Debian 12 (Bookworm)
```bash ```bash
# 1. 下载并添加 GPG 密钥 # 1. 下载并添加 GPG 密钥
sudo curl https://gitea.bcde.io/api/packages/wangdefa/debian/repository.key \ sudo curl https://gitea.bcde.io/api/packages/wangdefa/debian/repository.key \
-o /etc/apt/keyrings/gitea-wangdefa.asc -o /etc/apt/keyrings/gitea-wangdefa.asc
# 2. 添加软件源 # 2. 添加软件源
echo "deb [signed-by=/etc/apt/keyrings/gitea-wangdefa.asc] https://gitea.bcde.io/api/packages/wangdefa/debian bookworm 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. 安装
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 sudo tee -a /etc/apt/sources.list.d/wangdefa.list
# 3. 安装 # 3. 安装

18
llmdoc/guides/how-to-release.md
View File

@@ -38,17 +38,17 @@ git push origin v1.2.3
## 4. 包管理仓库上传 ## 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. 发布后验证 ## 5. 发布后验证

29
llmdoc/index.md
View File

@@ -1,20 +1,21 @@
# Mond 项目文档 # Mond 文档
## 概述 ## 概览
Mond 是一个基于 Monero 的区块链项目，专注于隐私和去中心化。
## 文档导航 [项目概述](/overview/project-overview.md)
### 项目概览 ## 指南
- [项目背景](/overview/project-overview.md)
- [系统配置参考](/reference/configuration.md)
### 构建指南 - [安装指南](/guides/installation.md)
- [如何构建项目](/guides/how-to-build.md)
### 架构 ## 架构
- [构建系统](/architecture/build-system.md)
### 参考 - [系统设计](/architecture/system-design.md)
- [常见问题](/reference/faq.md)
- [配置文件详解](/reference/configuration.md) ## 参考资料
- [配置参考](/reference/configuration-reference.md)
## 许可证
本文档遵循 BSD-3-Clause 许可证，与 Mond 项目保持一致。

23
llmdoc/overview/project-overview.md
View File

@@ -1,12 +1,19 @@
# Mond 项目概览 # Mond: Monero Daemon 定制版
## 1. 项目定位 ## 1. 身份
Mond 是一个基于 Monero 区块链技术的开源项目，专注于提供更加安全、私密的去中心化交易解决方案。 - **定义**：Monero 守护进程的定制开源实现
- **目的**：提供高度可移植、易于部署的 Monero 节点解决方案
## 2. 核心特点 ## 2. 高级描述
- 高度私密的交易机制 Mond 是基于 Monero 项目的定制守护进程实现，专注于多架构支持、简化部署和增强可移植性。通过纯静态链接和多种安装方式，Mond 为不同 Linux 环境中运行 Monero 节点提供了灵活的选择。
- 基于 Monero 核心技术
- 跨平台支持（Ubuntu, Alpine Linux, amd64/arm64） ## 3. 关键特性
- 灵活的构建系统
- 多架构支持（AMD64、ARM64）
- 多发行版兼容（Ubuntu、Debian）
- 纯静态链接
- 灵活的安装和配置选项
- 隐私保护
- 自动更新支持

24
llmdoc/reference/configuration-reference.md Normal file
View File

@@ -0,0 +1,24 @@
# Mond 参考信息
## 核心摘要
Mond 是 Monero 守护进程的定制开源实现，提供高度可配置和可移植的 Monero 节点解决方案。
## 关键信息源
- **源代码库**：https://github.com/monero-project/monero
- **官方网站**：未定义（本项目为定制版）
- **授权协议**：BSD-3-Clause
## 配置选项参考
### 常用命令行参数
- `--data-dir <path>`：指定数据目录
- `--log-file <path>`：指定日志文件路径
- `--log-level <level>`：日志级别（0-4）
- `--detach`：后台运行
- `--rpc-bind-ip <ip>`：RPC 绑定 IP
- `--rpc-bind-port <port>`：RPC 绑定端口
- `--p2p-bind-ip <ip>`：P2P 绑定 IP
- `--p2p-bind-port <port>`：P2P 绑定端口