CBSD 项目技术文档

本文档旨在帮助用户安装、使用 CBSD 项目，并详细介绍其 API 使用方法。

1. 安装指南

1.1 环境要求

CBSD 项目经过测试，适用于以下操作系统和发行版：

• FreeBSD 14.0+
• HardenedBSD
• DragonFly BSD

1.2 安装依赖

首先，安装以下依赖：

pkg install sudo libssh2 rsync sqlite3 git pkgconf

1.3 克隆项目

从 GitHub 克隆最新的 CBSD 版本：

git clone https://github.com/cbsd/cbsd.git /usr/local/cbsd

1.4 创建 CBSD 用户

pw useradd cbsd -s /bin/sh -d /nonexistent -c "cbsd user"

1.5 配置系统启动

将 rc.d 脚本链接到系统启动目录，并创建链接到 bsdconfig 模块：

cd /usr/local/etc/rc.d
ln -s /usr/local/cbsd/rc.d/cbsdd
ln -s /usr/local/cbsd/rc.d/cbsdrsyncd
mkdir -p /usr/local/libexec/bsdconfig
ln -s /usr/local/cbsd/share/bsdconfig/cbsd /usr/local/libexec/bsdconfig/cbsd

1.6 初始化设置

按照 常规步骤 进行初始化设置：

env workdir=/usr/jails /usr/local/cbsd/sudoexec/initenv

请注意，当运行 initenv 脚本时，所有二进制文件和组件将被编译并安装。

2. 项目使用说明

CBSD 项目的快速入门指南请访问：快速入门

详细安装和使用说明请参考：文档

3. 项目 API 使用文档

CBSD 项目提供了以下 API：

• sysutils/cbsd-mq-api
• MyBee: https://myb.convectix.com

4. 项目安装方式

CBSD 项目的安装方式如下：

4.1 开发版本安装

a) 安装依赖

pkg install sudo libssh2 rsync sqlite3 git pkgconf

b) 克隆项目

git clone https://github.com/cbsd/cbsd.git /usr/local/cbsd

c) 创建 CBSD 用户

pw useradd cbsd -s /bin/sh -d /nonexistent -c "cbsd user"

d) 配置系统启动

cd /usr/local/etc/rc.d
ln -s /usr/local/cbsd/rc.d/cbsdd
ln -s /usr/local/cbsd/rc.d/cbsdrsyncd
mkdir -p /usr/local/libexec/bsdconfig
ln -s /usr/local/cbsd/share/bsdconfig/cbsd /usr/local/libexec/bsdconfig/cbsd

e) 初始化设置

env workdir=/usr/jails /usr/local/cbsd/sudoexec/initenv

请注意，当运行 initenv 脚本时，所有二进制文件和组件将被编译并安装。