linux服务之 .service文件

.service 文件是 Linux 系统中 systemd 服务管理器的配置文件，用于定义如何启动、管理和监控系统服务（如后台程序、守护进程等）。以下是它的核心作用和详细使用指南：

---

一、.service 文件的核心作用

1. 定义服务行为
   描述服务的启动命令、依赖关系、重启策略、运行环境等。
2. 服务生命周期管理
   通过 systemctl 命令启动、停止、重启服务，或设置开机自启。
3. 统一管理标准
   标准化服务的配置方式，简化运维操作。

---

二、.service 文件的核心结构

一个典型的 .service 文件分为三个部分（以 [Unit]、[Service]、[Install] 为块）：

1. [Unit] 块

定义服务的元信息和依赖关系。

[Unit]
Description=服务描述
After=依赖的目标或服务（如 network.target）
Requires=强依赖的其他服务
Wants=弱依赖的其他服务

2. [Service] 块

定义服务运行的具体行为。

[Service]
Type=服务类型（simple, forking, oneshot 等）
ExecStart=启动命令
Restart=重启策略（no, on-failure, always）
User=运行服务的用户
Group=运行服务的用户组
Environment=环境变量（如 PATH=/usr/bin）
WorkingDirectory=工作目录

3. [Install] 块

定义如何将服务安装到系统启动目标。

[Install]
WantedBy=multi-user.target  # 关联到多用户命令行模式

---

三、如何使用 .service 文件

场景示例：部署一个自定义服务（如 chogori-agent）

假设你有一个程序 /opt/chogori/bin/chogori-agent，需要将其配置为系统服务。

1. 创建 .service 文件

在 /etc/systemd/system/ 目录下创建文件 chogori-agent.service：

sudo nano /etc/systemd/system/chogori-agent.service

2. 编写服务配置

[Unit]
Description=Chogori Agent Service
After=network.target

[Service]
Type=simple
ExecStart=/opt/chogori/bin/chogori-agent \
  --config /opt/chogori/etc/agent.yaml \
  --log /var/log/chogori/agent.log
Restart=on-failure
User=chogori
Group=chogori
Environment="PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin"

[Install]
WantedBy=multi-user.target

3. 设置权限和路径

确保程序和配置文件可访问：

sudo mkdir -p /var/log/chogori
sudo chown -R chogori:chogori /opt/chogori /var/log/chogori

4. 重载 systemd 配置

sudo systemctl daemon-reload

5. 操作服务

• 启动服务：

  sudo systemctl start chogori-agent
  

• 设置开机自启：

  sudo systemctl enable chogori-agent
  

• 查看状态：

  systemctl status chogori-agent
  

• 停止服务：

  sudo systemctl stop chogori-agent
  

• 查看日志：

  journalctl -u chogori-agent -f
  

---

四、关键参数详解

1. [Service] 块核心参数

参数	作用
Type=simple	默认类型，直接运行 ExecStart 命令（前台运行）。
Type=forking	适用于后台守护进程（需自行 fork）。
Restart=on-failure	服务异常退出时自动重启（其他值：no, always, on-abnormal）。
User 和 Group	指定运行服务的用户和组（提升安全性）。

2. 环境变量设置

• 单变量：

  Environment="KEY=value"
  

• 多变量：

  Environment="KEY1=value1" "KEY2=value2"
  

---

五、常见问题排查

1. 服务启动失败

# 查看详细日志
journalctl -u chogori-agent -b --no-pager

• 常见原因：
  • ExecStart 路径错误。
  • 权限不足（用户/组或文件权限）。
  • 依赖服务未启动（如 After=postgresql.service 但 PostgreSQL 未运行）。

2. 服务无法开机自启

# 检查服务是否已启用
systemctl is-enabled chogori-agent

• 修复：

  sudo systemctl enable chogori-agent
  

---

六、总结

• .service 文件本质：是 systemd 的配置文件，用于定义服务的启动和管理规则。
• 核心操作：创建文件 → 编写配置 → 重载配置 → 启动/管理服务。
• 最佳实践：始终通过 systemctl 管理服务，而非直接运行程序。