Skip to content

feat: Add Systemd management #4

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
ANGJustinl wants to merge 3 commits into
base: master
Choose a base branch
from
Open

feat: Add Systemd management #4

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
4dc8daf
feat: Add Systemd management
ANGJustinl Oct 20, 2025
1229a02
feat: 使用更规范的表达
ANGJustinl Oct 26, 2025
88fa40e
feat: 更新 Docs tree，增加新方案和自定义配置文件支持
ANGJustinl Oct 26, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 2 additions & 1 deletion Writerside/lcf-help.tree
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -29,7 +29,8 @@
<toc-element toc-title="教程">
<toc-element toc-title="进程守护">
<toc-element topic="使用-Supervisor-管理和守护进程.md"/>
<toc-element topic="使用-Systemd-管理和守护进程.md"/>
<toc-element topic="使用-Systemd-管理和守护进程(从面板获取启动参数).md"/>
<toc-element topic="使用-Systemd-管理和守护进程(使用自定义配置文件).md"/>
<toc-element topic="使用-OpenRC-管理和守护进程.md"/>
</toc-element>
</toc-element>
Expand Down
53 changes: 53 additions & 0 deletions Writerside/topics/使用-Systemd-管理和守护进程(从面板获取启动参数).md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,53 @@
# 使用 Systemd 管理和守护进程 (从面板获取启动参数)

此方案适用于从 Web 面板获取 Token 和隧道 ID 的用户。

### 1. 假设路径
我们假设你的 `frpc` 可执行文件位于 `/opt/lcf/` 目录中，并在面板中配置了隧道。

### 2. 授予执行权限
```sh
chmod +x /opt/lcf/frpc
````

### 3. 创建 Systemd 服务

将以下内容保存为 `.service` 文件（例如 `lcf-frpc@.service`），存放于以下任一目录：

* `/etc/systemd/system/`
* `/usr/lib/systemd/system/`

<!-- end list -->

```ini
[Unit]
Description=LoCyanFrp Client
After=network.target

[Service]
Type=idle
Restart=on-failure
RestartSec=60s
WorkingDirectory=/opt/lcf
ExecStart=/bin/sh -c '/opt/lcf/frpc -u $(echo "%i" | cut -d ":" -f 1) -p $(echo "%i" | cut -d ":" -f 2)'

[Install]
WantedBy=multi-user.target
```

> **注意**：后续操作中，Systemd Unit 名称的格式为 `lcf-frpc@<Token>:<隧道ID>.service`。

### 4\. 启动并设置开机自启

例如，若 Token 为 `1919810`，隧道号为 `114514`，则执行：

```sh
# 启动并立即启用开机自启
systemctl enable lcf-frpc@1919810:114514.service --now

# 查看运行状态
systemctl status lcf-frpc@1919810:114514.service

# 查看详细日志
# journalctl -aeu lcf-frpc@1919810:114514.service
```
58 changes: 58 additions & 0 deletions Writerside/topics/使用-Systemd-管理和守护进程(使用自定义配置文件).md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,58 @@
# 使用 Systemd 管理和守护进程 (使用自定义 `frpc.ini` 配置文件)

此方案适用于使用本地 `frpc.ini` 完整配置文件的用户。

### 1\. 假设路径

假设 `frpc` 可执行文件和配置文件（例如 `frpc.ini`）均位于 `/opt/lcf/` 目录中。

### 2\. 授予执行权限

```sh
chmod +x /opt/lcf/frpc
```

### 3\. 创建 Systemd 服务

将以下内容保存为 `.service` 文件（例如 `lcf-frpc.service`），存放于以下任一目录：

* `/etc/systemd/system/`
* `/usr/lib/systemd/system/`

<!-- end list -->

```ini
[Unit]
Description=LoCyanFrp Client
After=network.target

[Service]
Type=simple
Restart=on-failure
RestartSec=5s
WorkingDirectory=/opt/lcf/
ExecStart=/opt/lcf/frpc -c ./frpc.ini

# 如果你的配置文件名不是 frpc.ini，请修改上面一行的 -c 参数，例如：
# ExecStart=/opt/lcf/frpc -c ./config.ini

[Install]
WantedBy=multi-user.target
```

### 4\. 启动并设置开机自启

```sh
# 启动并立即启用开机自启
systemctl enable lcf-frpc.service --now

# 查看运行状态
systemctl status lcf-frpc.service

# 查看详细日志
# journalctl -aeu lcf-frpc.service
```

-----

更多管理命令，请参阅: [Linux 中国: systemctl 命令完全指南](https://linux.cn/article-5926-1.html)
43 changes: 0 additions & 43 deletions Writerside/topics/使用-Systemd-管理和守护进程.md
View file
Open in desktop

This file was deleted.