SSH服务启动失败：sshd.service 单元未找到

Question

常见问题：在较新版本的 Alpine Linux、某些精简版容器镜像（如 distroless）或手动编译安装 OpenSSH 的系统中，`systemctl start sshd.service` 报错“Unit sshd.service not found”，本质并非 SSH 未安装，而是**缺少 systemd 服务单元文件**。这类系统通常默认使用 OpenRC（Alpine）、runit 或直接以前台进程方式运行 sshd（如 `sshd -D -e`），并未预置 `/usr/lib/systemd/system/sshd.service`。此外，若仅安装了 `openssh-client` 而非 `openssh-server`（如 Ubuntu/Debian 中），也会因服务文件缺失导致该错误。排查需先确认 `sshd` 二进制是否存在（`which sshd`）、服务端包是否安装、当前 init 系统类型（`ps -p 1 -o comm=`），再针对性配置启动方式——切勿盲目拷贝其他发行版的 service 文件，可能因路径、SELinux 或 Capability 差异引发新问题。

Answer 1

```html

一、现象层：错误表征与典型触发场景

执行 systemctl start sshd.service 时返回 Failed to start unit: Unit sshd.service not found，是容器化与轻量发行版环境中高频报错。该错误不等于 SSH 未安装，而是 systemd 无法识别服务单元——常见于：
• Alpine Linux 3.16+（默认使用 OpenRC，无 systemd）
• Google distroless、ubi-minimal、scratch 构建的镜像（零 init 系统）
• 手动编译 OpenSSH（./configure && make && make install）后未生成 service 文件
• Debian/Ubuntu 中仅运行 apt install openssh-client（遗漏 openssh-server 包）

二、诊断层：三阶定位法（Binary → Package → Init）

必须按顺序验证，避免误判：

1. 二进制存在性：which sshd || ls /usr/sbin/sshd /usr/local/sbin/sshd 2>/dev/null
2. 服务端包完整性：
   
   • Alpine：apk info -q openssh-server（非 openssh 或 openssh-client）
   • Debian/Ubuntu：dpkg -l | grep openssh-server 或 apt list --installed | grep ssh-server
   • RHEL/CentOS：rpm -q openssh-server
3. Init 系统类型：ps -p 1 -o comm= 返回结果决定启动范式：
   

   输出值	对应系统	推荐启动方式
   systemd	标准 CentOS/RHEL 8+, Ubuntu 16.04+	需部署 /usr/lib/systemd/system/sshd.service
   init	旧版 SysVinit（如 CentOS 6）	使用 service sshd start 或 /etc/init.d/sshd start
   openrc	Alpine Linux	rc-service sshd start && rc-update add sshd
   runit	Void Linux, Artix	sv start sshd（需确保 /etc/sv/sshd/run 存在）
   （空或 ?）	distroless/scratch 容器	必须前台运行：sshd -D -e -f /etc/ssh/sshd_config

三、根因层：systemd service 文件缺失的深层逻辑

service 文件并非“通用附件”，而是与发行版构建策略强耦合：
• Alpine 的 apk 包管理器不打包 systemd 单元（因其默认不用 systemd）；
• distroless 镜像设计哲学是「只含运行时必需」，明确排除所有 init 相关文件；
• 手动编译 OpenSSH 时，make install 默认不安装 service 文件（需额外调用 contrib/redhat/sshd.init 或指定 --with-systemdsystemunitdir）；
• 即便拷贝 Ubuntu 的 sshd.service 到 Alpine，也会因路径差异（如 /usr/sbin/sshd vs /usr/bin/sshd）、Capability 设置（Capabilities=CAP_NET_BIND_SERVICE 在 musl 下无效）、SELinux 标签缺失而静默失败。

四、解法层：按 Init 类型精准施策

以下为生产环境验证可行的启动方案（附关键注意事项）：

# ✅ Alpine Linux（OpenRC）
apk add openssh-server
rc-service sshd start
rc-update add sshd default
# 注意：确保 /etc/ssh/sshd_config 中 PermitRootLogin yes（容器调试常用）

# ✅ Distroless 容器（无 init，纯前台）
FROM gcr.io/distroless/base-debian12
COPY sshd_config /etc/ssh/sshd_config
COPY ssh_host_*_key* /etc/ssh/
ENTRYPOINT ["/usr/sbin/sshd"]
CMD ["-D", "-e", "-f", "/etc/ssh/sshd_config"]

# ✅ 手动编译 OpenSSH + systemd（需显式启用）
./configure --prefix=/usr --sysconfdir=/etc/ssh \
            --with-systemdsystemunitdir=/usr/lib/systemd/system \
            --with-pam --with-libedit
make && sudo make install
sudo systemctl daemon-reload
sudo systemctl enable sshd

五、防御层：构建期自动化检测流程图

graph TD
  A[启动前检查] --> B{which sshd?}
  B -->|No| C[ERROR: sshd binary missing]
  B -->|Yes| D{ps -p 1 -o comm=?}
  D -->|systemd| E[check /usr/lib/systemd/system/sshd.service]
  D -->|openrc| F[check /etc/init.d/sshd or rc-service list]
  D -->|runit| G[check /etc/sv/sshd/run]
  D -->|?| H[Assume foreground mode required]
  E -->|Missing| I[Generate minimal service file with correct paths]
  E -->|Exists| J[systemctl daemon-reload && start]
  I --> K[Validate with systemd-analyze verify sshd.service]

```