完善证书申请续期与安装初始化流程
This commit is contained in:
1 parent
fd8d8608f5
commit
07636abe44
66 files changed
+9470
-165
No files matched your search
@@ -0,0 +1,72 @@
|
||||
# Scert Linux 部署
|
||||
|
||||
## 安装包目录
|
||||
|
||||
Linux 安装包应将以下文件放在同一部署目录中:
|
||||
|
||||
```text
|
||||
deploy/
|
||||
├── install-linux.sh
|
||||
├── scert
|
||||
├── scert-admin
|
||||
└── systemd/
|
||||
├── Scert.service
|
||||
├── Scert-admin.service
|
||||
├── Scert服务管理说明.md
|
||||
└── Scert-admin服务管理说明.md
|
||||
```
|
||||
|
||||
二进制文件应针对目标平台构建为 Linux amd64,并且具有可执行权限。
|
||||
|
||||
## 安装命令
|
||||
|
||||
```bash
|
||||
chmod +x install-linux.sh scert scert-admin
|
||||
sudo ./install-linux.sh --source-dir .
|
||||
```
|
||||
|
||||
也可以显式指定产物目录:
|
||||
|
||||
```bash
|
||||
sudo ./install-linux.sh --source-dir /tmp/scert-linux-amd64
|
||||
```
|
||||
|
||||
## 安装器行为
|
||||
|
||||
安装器会:
|
||||
|
||||
1. 检查 Linux、root 权限、`systemctl` 和安装产物。
|
||||
2. 创建 `Scert` 系统用户和同名系统用户组,禁止交互式登录。
|
||||
3. 创建 `/scert`、`/scert/conf`、`/scert/data`、`/scert/log`、`/scert/backups`、`/scert/docs` 和证书目录。
|
||||
4. 安装 `scert`、`scert-admin` 以及两个 systemd unit。
|
||||
5. 设置安装目录、服务目录和配置目录权限,防止 `Scert` 运行用户替换 root 所有的程序文件。
|
||||
6. 为证书根目录生成 systemd drop-in,并执行一次 `systemctl daemon-reload`。
|
||||
|
||||
安装器不会:
|
||||
|
||||
- 执行 `systemctl enable Scert-admin`。
|
||||
- 启动或重启 `Scert-admin`。
|
||||
- 创建公网防火墙规则。
|
||||
- 删除已有配置、数据库、证书和备份。
|
||||
|
||||
## 安装后流程
|
||||
|
||||
安装完成后先运行初始化流程,填写超级管理员、邮件、DNS API、端口和证书路径配置。初始化流程负责 DNS API 验证、Web 证书申请、部署校验和主服务端口防火墙处理。
|
||||
|
||||
`Scert-admin` 默认保持停止状态。确有密码重置需求时,仅使用:
|
||||
|
||||
```bash
|
||||
systemctl start Scert-admin
|
||||
systemctl stop Scert-admin
|
||||
```
|
||||
|
||||
该服务只允许回环监听,不应为其创建公网或局域网入站规则。云安全组仍需由管理员根据初始化提示手动放行主服务端口。
|
||||
|
||||
## 参数说明
|
||||
|
||||
- `--source-dir`:包含两个 Linux 可执行文件的目录,默认是安装器所在目录。
|
||||
- `--certificate-dir`:证书根目录参数,默认 `/ssl`。安装器会创建该目录,写入 `/scert/conf/installation.json`,并生成对应的 `Scert.service.d/10-certificate-path.conf`。首次初始化会读取该记录作为证书目录默认值。
|
||||
|
||||
Linux 安装目录当前固定为 `/scert`。自定义证书根目录必须是规范化的安全绝对路径,只允许字母、数字、点、下划线、连字符和斜杠,不允许空格、`..` 路径片段、符号链接、受保护系统目录或 `/scert` 下的路径;`/var` 下仅允许 `/var/lib/scert` 专用目录。
|
||||
|
||||
安装器是文件部署阶段,不负责替代首次初始化向导,也不代替真实 ACME 申请和远程部署验收。
|
||||
@@ -0,0 +1,277 @@
|
||||
#!/usr/bin/env bash
|
||||
set -Eeuo pipefail
|
||||
|
||||
readonly SCRIPT_DIR="$(cd -- "$(dirname -- "${BASH_SOURCE[0]}")" && pwd)"
|
||||
readonly INSTALL_DIR="/scert"
|
||||
readonly DEFAULT_CERTIFICATE_DIR="/ssl"
|
||||
readonly SERVICE_USER="Scert"
|
||||
readonly SERVICE_GROUP="Scert"
|
||||
readonly SERVICE_DIR="/etc/systemd/system"
|
||||
readonly SERVICE_DROP_IN_DIR="$SERVICE_DIR/Scert.service.d"
|
||||
readonly INSTALL_METADATA_FILE="$INSTALL_DIR/conf/installation.json"
|
||||
|
||||
source_dir="$SCRIPT_DIR"
|
||||
certificate_dir="$DEFAULT_CERTIFICATE_DIR"
|
||||
nologin_shell=""
|
||||
|
||||
print_usage() {
|
||||
cat <<'USAGE'
|
||||
Scert Linux 安装器
|
||||
|
||||
用法:
|
||||
sudo ./install-linux.sh [选项]
|
||||
|
||||
选项:
|
||||
--source-dir DIR 安装产物目录,必须包含 scert 和 scert-admin
|
||||
--certificate-dir DIR 证书根目录,默认 /ssl
|
||||
-h, --help 显示帮助
|
||||
|
||||
Linux 安装目录固定为 /scert,证书业务目录可在首次初始化时继续配置。
|
||||
安装器只负责安装文件、创建运行用户和目录、注册 systemd unit,并执行一次
|
||||
systemctl daemon-reload。安装器不会启动或启用 Scert-admin,也不会创建公网防火墙规则。
|
||||
USAGE
|
||||
}
|
||||
|
||||
fail() {
|
||||
printf '安装失败:%s\n' "$1" >&2
|
||||
exit 1
|
||||
}
|
||||
|
||||
parse_args() {
|
||||
while (($# > 0)); do
|
||||
case "$1" in
|
||||
--source-dir)
|
||||
(($# >= 2)) || fail "--source-dir 缺少参数"
|
||||
source_dir="$2"
|
||||
shift 2
|
||||
;;
|
||||
--certificate-dir)
|
||||
(($# >= 2)) || fail "--certificate-dir 缺少参数"
|
||||
certificate_dir="$2"
|
||||
shift 2
|
||||
;;
|
||||
-h|--help)
|
||||
print_usage
|
||||
exit 0
|
||||
;;
|
||||
*)
|
||||
fail "不支持的参数:$1"
|
||||
;;
|
||||
esac
|
||||
done
|
||||
}
|
||||
|
||||
validate_certificate_dir() {
|
||||
[[ "$certificate_dir" == /* ]] || fail "证书目录必须是绝对路径"
|
||||
[[ "$certificate_dir" != "/" ]] || fail "证书目录不能是根目录"
|
||||
[[ "$certificate_dir" =~ ^/[A-Za-z0-9._/-]+$ ]] || fail "证书目录只能包含字母、数字、点、下划线、连字符和斜杠"
|
||||
[[ ! "$certificate_dir" =~ (^|/)\.\.(/|$) ]] || fail "证书目录不能包含上级目录片段"
|
||||
|
||||
reject_symlink_path "$certificate_dir" "证书目录"
|
||||
certificate_dir="$(readlink -m -- "$certificate_dir")"
|
||||
[[ "$certificate_dir" != "/" ]] || fail "证书目录不能是根目录"
|
||||
|
||||
case "$certificate_dir" in
|
||||
/bin|/bin/*|/boot|/boot/*|/dev|/dev/*|/etc|/etc/*|/home|/home/*|/lib|/lib/*|/lib64|/lib64/*|/proc|/proc/*|/root|/root/*|/run|/run/*|/sbin|/sbin/*|/sys|/sys/*|/tmp|/tmp/*|/usr|/usr/*)
|
||||
fail "证书目录不能位于受保护的系统路径:$certificate_dir"
|
||||
;;
|
||||
/var|/var/*)
|
||||
case "$certificate_dir" in
|
||||
/var/lib/scert|/var/lib/scert/*) ;;
|
||||
*) fail "证书目录只能使用 /var/lib/scert 下的专用路径:$certificate_dir" ;;
|
||||
esac
|
||||
;;
|
||||
/scert|/scert/*)
|
||||
fail "证书目录不能覆盖 Scert 的安装、配置、数据、日志、备份或文档目录:$certificate_dir"
|
||||
;;
|
||||
esac
|
||||
|
||||
}
|
||||
|
||||
reject_symlink_path() {
|
||||
local target_path="$1"
|
||||
local description="$2"
|
||||
local current_path=""
|
||||
local part
|
||||
local -a path_parts
|
||||
IFS='/' read -r -a path_parts <<< "${target_path#/}"
|
||||
for part in "${path_parts[@]}"; do
|
||||
[[ -n "$part" ]] || continue
|
||||
current_path="$current_path/$part"
|
||||
if [[ -L "$current_path" ]]; then
|
||||
fail "$description 不能包含符号链接:$current_path"
|
||||
fi
|
||||
done
|
||||
}
|
||||
|
||||
validate_managed_paths() {
|
||||
local managed_path
|
||||
for managed_path in \
|
||||
"$INSTALL_DIR" \
|
||||
"$INSTALL_DIR/conf" \
|
||||
"$INSTALL_DIR/data" \
|
||||
"$INSTALL_DIR/log" \
|
||||
"$INSTALL_DIR/backups" \
|
||||
"$INSTALL_DIR/docs" \
|
||||
"$INSTALL_DIR/scert" \
|
||||
"$INSTALL_DIR/scert-admin" \
|
||||
"$INSTALL_METADATA_FILE" \
|
||||
"$INSTALL_DIR/docs/Scert服务管理说明.md" \
|
||||
"$INSTALL_DIR/docs/Scert-admin服务管理说明.md" \
|
||||
"$SERVICE_DIR/Scert.service" \
|
||||
"$SERVICE_DIR/Scert-admin.service" \
|
||||
"$SERVICE_DROP_IN_DIR" \
|
||||
"$SERVICE_DROP_IN_DIR/10-certificate-path.conf"; do
|
||||
reject_symlink_path "$managed_path" "Scert 受管路径"
|
||||
done
|
||||
}
|
||||
|
||||
validate_environment() {
|
||||
[[ "$(uname -s)" == "Linux" ]] || fail "此安装器只支持 Linux"
|
||||
[[ "$(id -u)" -eq 0 ]] || fail "请使用 root 或 sudo 运行安装器"
|
||||
local command_name
|
||||
for command_name in install systemctl getent groupadd useradd id chmod chown cut grep readlink; do
|
||||
command -v "$command_name" >/dev/null 2>&1 || fail "找不到系统命令:$command_name"
|
||||
done
|
||||
nologin_shell="$(command -v nologin || true)"
|
||||
[[ -n "$nologin_shell" ]] || fail "找不到 nologin,无法创建禁止登录的服务用户"
|
||||
validate_certificate_dir
|
||||
validate_managed_paths
|
||||
}
|
||||
|
||||
validate_artifacts() {
|
||||
[[ -d "$source_dir" ]] || fail "安装产物目录不存在:$source_dir"
|
||||
source_dir="$(cd -- "$source_dir" && pwd)"
|
||||
local artifact
|
||||
for artifact in scert scert-admin; do
|
||||
[[ -f "$source_dir/$artifact" ]] || fail "安装产物不存在:$source_dir/$artifact"
|
||||
[[ -x "$source_dir/$artifact" ]] || fail "安装产物不可执行:$source_dir/$artifact"
|
||||
done
|
||||
[[ -f "$SCRIPT_DIR/systemd/Scert.service" ]] || fail "缺少 Scert systemd unit"
|
||||
[[ -f "$SCRIPT_DIR/systemd/Scert-admin.service" ]] || fail "缺少 Scert-admin systemd unit"
|
||||
[[ -f "$SCRIPT_DIR/systemd/Scert-admin服务管理说明.md" ]] || fail "缺少 Scert-admin 服务管理说明"
|
||||
[[ -f "$SCRIPT_DIR/systemd/Scert服务管理说明.md" ]] || fail "缺少 Scert 服务管理说明"
|
||||
}
|
||||
|
||||
ensure_service_account() {
|
||||
if ! getent group "$SERVICE_GROUP" >/dev/null 2>&1; then
|
||||
if ! groupadd --system "$SERVICE_GROUP"; then
|
||||
if groupadd --help 2>&1 | grep -q -- '--badname'; then
|
||||
groupadd --system --badname "$SERVICE_GROUP"
|
||||
else
|
||||
fail "当前系统无法创建名称为 $SERVICE_GROUP 的系统用户组"
|
||||
fi
|
||||
fi
|
||||
fi
|
||||
if ! id "$SERVICE_USER" >/dev/null 2>&1; then
|
||||
if ! useradd --system --gid "$SERVICE_GROUP" --home-dir "$INSTALL_DIR" --shell "$nologin_shell" "$SERVICE_USER"; then
|
||||
if useradd --help 2>&1 | grep -q -- '--badname'; then
|
||||
useradd --system --badname --gid "$SERVICE_GROUP" --home-dir "$INSTALL_DIR" --shell "$nologin_shell" "$SERVICE_USER"
|
||||
else
|
||||
fail "当前系统无法创建名称为 $SERVICE_USER 的系统用户"
|
||||
fi
|
||||
fi
|
||||
fi
|
||||
[[ "$(id -gn "$SERVICE_USER")" == "$SERVICE_GROUP" ]] || fail "用户 $SERVICE_USER 未使用预期用户组 $SERVICE_GROUP"
|
||||
local current_shell
|
||||
current_shell="$(getent passwd "$SERVICE_USER" | cut -d: -f7)"
|
||||
case "$current_shell" in
|
||||
*/nologin|*/false) ;;
|
||||
*) fail "现有用户 $SERVICE_USER 允许交互式登录,请先修正其登录 Shell" ;;
|
||||
esac
|
||||
}
|
||||
|
||||
create_directories() {
|
||||
install -d -o root -g "$SERVICE_GROUP" -m 0750 "$INSTALL_DIR"
|
||||
install -d -o root -g root -m 0755 "$INSTALL_DIR/docs"
|
||||
install -d -o "$SERVICE_USER" -g "$SERVICE_GROUP" -m 0750 \
|
||||
"$INSTALL_DIR/conf" \
|
||||
"$INSTALL_DIR/data" \
|
||||
"$INSTALL_DIR/log" \
|
||||
"$INSTALL_DIR/backups"
|
||||
install -d -o "$SERVICE_USER" -g "$SERVICE_GROUP" -m 0750 "$certificate_dir"
|
||||
chown -R -h "$SERVICE_USER:$SERVICE_GROUP" \
|
||||
"$INSTALL_DIR/conf" \
|
||||
"$INSTALL_DIR/data" \
|
||||
"$INSTALL_DIR/log" \
|
||||
"$INSTALL_DIR/backups"
|
||||
chmod 0700 "$INSTALL_DIR/conf"
|
||||
|
||||
local sensitive_file
|
||||
for sensitive_file in scert.json master.key secrets.json; do
|
||||
if [[ -f "$INSTALL_DIR/conf/$sensitive_file" ]]; then
|
||||
chown "$SERVICE_USER:$SERVICE_GROUP" "$INSTALL_DIR/conf/$sensitive_file"
|
||||
chmod 0600 "$INSTALL_DIR/conf/$sensitive_file"
|
||||
fi
|
||||
done
|
||||
}
|
||||
|
||||
write_install_metadata() {
|
||||
printf '{\n "certificate_root": "%s"\n}\n' "$certificate_dir" > "$INSTALL_METADATA_FILE"
|
||||
chown root:"$SERVICE_GROUP" "$INSTALL_METADATA_FILE"
|
||||
chmod 0640 "$INSTALL_METADATA_FILE"
|
||||
}
|
||||
|
||||
install_binaries() {
|
||||
install -o root -g root -m 0755 "$source_dir/scert" "$INSTALL_DIR/scert"
|
||||
install -o root -g root -m 0755 "$source_dir/scert-admin" "$INSTALL_DIR/scert-admin"
|
||||
}
|
||||
|
||||
install_service_files() {
|
||||
install -o root -g root -m 0644 "$SCRIPT_DIR/systemd/Scert.service" "$SERVICE_DIR/Scert.service"
|
||||
install -o root -g root -m 0644 "$SCRIPT_DIR/systemd/Scert-admin.service" "$SERVICE_DIR/Scert-admin.service"
|
||||
install -d -o root -g root -m 0755 "$SERVICE_DROP_IN_DIR"
|
||||
printf '[Service]\nReadWritePaths=\nReadWritePaths=%s /scert/conf /scert/data /scert/log /scert/backups\n' \
|
||||
"$certificate_dir" > "$SERVICE_DROP_IN_DIR/10-certificate-path.conf"
|
||||
chmod 0644 "$SERVICE_DROP_IN_DIR/10-certificate-path.conf"
|
||||
|
||||
install -o root -g root -m 0644 \
|
||||
"$SCRIPT_DIR/systemd/Scert服务管理说明.md" \
|
||||
"$INSTALL_DIR/docs/Scert服务管理说明.md"
|
||||
install -o root -g root -m 0644 \
|
||||
"$SCRIPT_DIR/systemd/Scert-admin服务管理说明.md" \
|
||||
"$INSTALL_DIR/docs/Scert-admin服务管理说明.md"
|
||||
}
|
||||
|
||||
reload_systemd() {
|
||||
systemctl daemon-reload
|
||||
}
|
||||
|
||||
print_completion() {
|
||||
printf '%s\n' \
|
||||
'Scert Linux 文件安装完成。' \
|
||||
'' \
|
||||
'已安装:' \
|
||||
' 核心程序:/scert/scert' \
|
||||
' 密码重置程序:/scert/scert-admin' \
|
||||
' 配置目录:/scert/conf' \
|
||||
' 数据目录:/scert/data' \
|
||||
' 日志目录:/scert/log' \
|
||||
' 备份目录:/scert/backups' \
|
||||
" 证书目录:$certificate_dir" \
|
||||
" 安装路径记录:$INSTALL_METADATA_FILE" \
|
||||
'' \
|
||||
'本次只加载了 systemd unit,没有启动任何服务,也没有设置开机启动。' \
|
||||
'首次初始化会读取安装路径记录,并将上述证书目录作为默认值。' \
|
||||
'请先完成初始化配置。Scert-admin 需要密码重置时,管理员仅使用:' \
|
||||
' systemctl start Scert-admin' \
|
||||
' systemctl stop Scert-admin' \
|
||||
'' \
|
||||
'Scert 主服务是否启用和启动,应在初始化配置及证书部署完成后按运维流程执行。' \
|
||||
'本机防火墙和云安全组端口放行由初始化流程处理或提示,不由本安装器创建公网规则。'
|
||||
}
|
||||
|
||||
main() {
|
||||
parse_args "$@"
|
||||
validate_environment
|
||||
validate_artifacts
|
||||
ensure_service_account
|
||||
create_directories
|
||||
write_install_metadata
|
||||
install_binaries
|
||||
install_service_files
|
||||
reload_systemd
|
||||
print_completion
|
||||
}
|
||||
|
||||
main "$@"
|
||||
@@ -0,0 +1,27 @@
|
||||
[Unit]
|
||||
Description=Scert-admin 本地密码重置服务
|
||||
Documentation=file:///scert/docs/Scert-admin服务管理说明.md
|
||||
After=network-online.target
|
||||
Wants=network-online.target
|
||||
ConditionPathExists=/scert/conf/scert.json
|
||||
|
||||
[Service]
|
||||
Type=simple
|
||||
User=Scert
|
||||
Group=Scert
|
||||
WorkingDirectory=/scert
|
||||
ExecStart=/scert/scert-admin --config /scert/conf/scert.json
|
||||
KillSignal=SIGTERM
|
||||
TimeoutStopSec=15
|
||||
Restart=no
|
||||
UMask=0077
|
||||
NoNewPrivileges=yes
|
||||
PrivateTmp=yes
|
||||
ProtectHome=yes
|
||||
ProtectSystem=full
|
||||
ReadWritePaths=/scert/conf /scert/data /scert/log /scert/backups
|
||||
RestrictAddressFamilies=AF_UNIX AF_INET AF_INET6
|
||||
|
||||
# Scert-admin 由程序层强制只允许监听回环地址;本服务不创建公网防火墙规则。
|
||||
# 刻意不提供 [Install] 段,禁止通过 systemctl enable 纳入开机启动。
|
||||
# 不配置 ExecReload,reload 不属于受支持的控制操作。
|
||||
@@ -0,0 +1,53 @@
|
||||
# Scert-admin 服务管理说明
|
||||
|
||||
## 服务边界
|
||||
|
||||
`Scert-admin` 是超级管理员密码重置服务,仅允许在本机回环地址监听。它不应被配置为公网服务,也不应为其创建本机防火墙入站规则。
|
||||
|
||||
Linux 安装程序必须同时安装 `Scert` 和 `Scert-admin` 的 systemd 单元,但不得执行 `systemctl enable Scert-admin`,不得为 `Scert-admin` 创建开机启动软链接,也不得配置 `Restart=always` 或其他自动拉起策略。
|
||||
|
||||
## 支持的生命周期控制
|
||||
|
||||
日常运行时,`Scert-admin` 只支持以下两个控制命令:
|
||||
|
||||
```bash
|
||||
systemctl start Scert-admin
|
||||
systemctl stop Scert-admin
|
||||
```
|
||||
|
||||
- `start`:按配置启动本机密码重置服务。
|
||||
- `stop`:停止本机密码重置服务。
|
||||
- `restart`、`reload`、`try-restart` 等操作不属于 Scert-admin 的支持范围;单元不提供 `ExecReload`,且不配置自动重启。
|
||||
- `enable` 不应使用:该单元没有 `[Install]` 段,因此不会注册开机启动目标。
|
||||
- `daemon-reload` 仅允许由安装、升级程序在替换 unit 文件后执行,不属于日常服务控制命令。
|
||||
|
||||
## 安全限制说明
|
||||
|
||||
systemd 无法阻止 root 或具备等效系统权限的操作者调用 `status`、`kill`、`restart`、`mask` 等管理命令。因此,本项目的可落地安全边界是:
|
||||
|
||||
1. 单元不提供 `[Install]` 段,默认不会开机自启动。
|
||||
2. 单元使用 `Restart=no`,异常退出不会被 systemd 自动拉起。
|
||||
3. 进程使用 `Scert` 用户运行,并由程序层拒绝非回环监听地址。
|
||||
4. 初始化程序不开放 `Scert-admin` 端口,不创建其防火墙规则。
|
||||
5. 安装器、桌面端和运维文档只提供 `start`、`stop` 两个日常控制入口。
|
||||
6. 任何需要重新加载 unit 的行为仅限安装或升级阶段,不能通过 Web 管理界面触发。
|
||||
|
||||
这组限制可以避免服务因安装配置被纳入开机启动、避免服务自动反复拉起,并避免密码重置端口暴露给公网;不能把拥有 root 权限的恶意操作者从 systemd 管理能力中排除。
|
||||
|
||||
## 安装阶段约定
|
||||
|
||||
安装器完成 unit 文件复制后,可以执行一次:
|
||||
|
||||
```bash
|
||||
systemctl daemon-reload
|
||||
```
|
||||
|
||||
安装器不得执行以下命令:
|
||||
|
||||
```bash
|
||||
systemctl enable Scert-admin
|
||||
systemctl start Scert-admin
|
||||
systemctl restart Scert-admin
|
||||
```
|
||||
|
||||
安装完成后只提示管理员在确有需要时手动执行 `systemctl start Scert-admin`;不需要密码重置时保持服务停止。
|
||||
@@ -0,0 +1,26 @@
|
||||
[Unit]
|
||||
Description=Scert SSL 证书管理核心服务
|
||||
Documentation=file:///scert/docs/Scert服务管理说明.md
|
||||
After=network-online.target
|
||||
Wants=network-online.target
|
||||
ConditionPathExists=/scert/conf/scert.json
|
||||
|
||||
[Service]
|
||||
Type=simple
|
||||
User=Scert
|
||||
Group=Scert
|
||||
WorkingDirectory=/scert
|
||||
ExecStart=/scert/scert --config /scert/conf/scert.json serve
|
||||
KillSignal=SIGTERM
|
||||
TimeoutStopSec=30
|
||||
Restart=on-failure
|
||||
UMask=0077
|
||||
NoNewPrivileges=yes
|
||||
PrivateTmp=yes
|
||||
ProtectHome=yes
|
||||
ProtectSystem=full
|
||||
ReadWritePaths=/ssl /scert/conf /scert/data /scert/log /scert/backups
|
||||
RestrictAddressFamilies=AF_UNIX AF_INET AF_INET6
|
||||
|
||||
[Install]
|
||||
WantedBy=multi-user.target
|
||||
@@ -0,0 +1,37 @@
|
||||
# Scert 服务管理说明
|
||||
|
||||
## 核心服务职责
|
||||
|
||||
`Scert` 是证书管理核心服务,负责 Web 管理接口、证书任务、数据库访问和后续的申请、续期、部署与校验流程。服务运行用户为 `Scert`,默认工作目录为 `/scert`。
|
||||
|
||||
## 安装阶段
|
||||
|
||||
Linux 安装器安装二进制文件、目录和两个 systemd unit,并执行一次:
|
||||
|
||||
```bash
|
||||
systemctl daemon-reload
|
||||
```
|
||||
|
||||
安装器不会在初始化配置完成前启动核心服务,也不会启用 `Scert-admin`。
|
||||
|
||||
## 日常服务控制
|
||||
|
||||
核心服务的启停应由初始化和运维流程根据配置状态执行。`Scert-admin` 与核心服务相互独立,不能把密码重置服务当作核心服务的自动启动依赖。
|
||||
|
||||
## 默认目录
|
||||
|
||||
```text
|
||||
/scert 安装目录
|
||||
/scert/conf 配置目录
|
||||
/scert/data 数据目录
|
||||
/scert/log 日志目录
|
||||
/scert/backups 备份目录
|
||||
/ssl 证书根目录
|
||||
```
|
||||
|
||||
## 安全要求
|
||||
|
||||
- 核心服务使用 `Scert` 用户运行。
|
||||
- 配置目录仅允许服务用户和 root 管理。
|
||||
- 证书私钥由服务用户生成和使用,Linux 权限应保持为 `0600`;root 仍可进行系统级管理。
|
||||
- 安装、升级和卸载不得删除用户证书、数据库和备份。
|
||||
Reference in new issue
Block a user