$ systemctl status OliveTin --no-pager | head -6
● OliveTin.service - OliveTin
     Loaded: loaded (/etc/systemd/system/OliveTin.service; enabled)
     Active: active (running) since Tue 2026-10-28 12:00:00 CST; 5min ago
   Main PID: 561234 (OliveTin)
     ...
$ systemctl restart OliveTin        # 重启（改监听地址等需重启的参数后）
$ journalctl -u OliveTin -f         # 跟踪运行日志（等同编排形态的 docker logs -f）

level=info msg="config file changed: WRITE \"/config/config.yaml\"" ... live-reload

$ OliveTin -configdir /etc/OliveTin
level=info msg="Starting OliveTin"
level=info msg="Adding action" title="Hello World"
...Ctrl+C 退出

$ OliveTin --help
Usage of ./OliveTin:
  -configdir string
        (default ".")
  -startuptrace
        print the startup trace messages
  -syntaxcheck
        Check the configuration file and exit

# 状态三查：进程、监听、版本
$ systemctl is-active OliveTin && ss -ltn | grep 1337
active
LISTEN 0 4096 *:1337  *:*

# 运行日志（错误从这找）
$ journalctl -u OliveTin -n 50 --no-pager

# 配置改动后先校验再等热重载
$ OliveTin -configdir /etc/OliveTin -syntaxcheck; echo "EXIT=$?"

# 服务健康探针（API 层，无需认证）
$ curl -s -X POST http://127.0.0.1:8130/api/olivetin.api.v1.OliveTinApiService/GetReadyz \
    -H 'Content-Type: application/json' -d '{}'
{"status":"OK"}

# 当前登录身份核验（排 ACL 问题时第一步）
$ curl -s -b cookies.txt -X POST http://127.0.0.1:8130/api/olivetin.api.v1.OliveTinApiService/WhoAmI \
    -H 'Content-Type: application/json' -d '{}'
{
    "authenticatedUser": "admin",
    "usergroup": "admins",
    "provider": "local",
    "acls": [
        "admin-full"
    ],
    "sid": "698026ab-2f6a-4836-98d1-67fd0a4bc98e"
}

$ BASE=http://127.0.0.1:8130/api/olivetin.api.v1.OliveTinApiService
# 1. 登录拿 Cookie
$ curl -s -c cookies.txt -X POST $BASE/LocalUserLogin \
    -H 'Content-Type: application/json' \
    -d '{"username": "admin", "password": "q1w2e3r4"}'
{"success": true}
# 2. 触发并等待结果（actionId 用配置里显式定义的 id）
$ curl -s -b cookies.txt -X POST $BASE/StartActionAndWait \
    -H 'Content-Type: application/json' \
    -d '{"actionId": "webhook_demo"}'
{"logEntry": {"actionTitle": "Webhook 触发任务", "exitCode": 0, "output": "webhook triggered at 2026-10-28 13:05:12\n", ...}}
# 3. 异步触发（立即返回追踪 ID）
$ curl -s -b cookies.txt -X POST $BASE/StartAction \
    -H 'Content-Type: application/json' \
    -d '{"bindingId": "bb7c1758-d29c-40a7-a702-a2856c5d8e66"}'
{"executionTrackingId": "5e7f0b28-..."}
# 4. 从日志流里核对执行结果（blocked/exitCode/output 逐条可查）
$ curl -s -b cookies.txt -X POST $BASE/GetLogs \
    -H 'Content-Type: application/json' -d '{}' | jq '.logs[0] | {actionTitle, exitCode, blocked, output}'

$ curl -s -b cookies.txt -X POST $BASE/StartActionAndWait \
    -H 'Content-Type: application/json' \
    -d '{"actionId": "6d31e4bd-...", "arguments": [{"name": "host", "value": "127.0.0.1"}, {"name": "count", "value": "1"}]}'
{"logEntry": {"exitCode": 0, "output": "PING 127.0.0.1 (127.0.0.1): 56 data bytes\n64 bytes from 127.0.0.1: seq=0 ttl=42 time=0.045 ms\n\n--- 127.0.0.1 ping statistics ---\n1 packets transmitted, 1 packets received, 0% packet loss\n"}}

actions:
  - title: Webhook 触发任务
    id: webhook_demo
    icon: "\U0001FA9C"
    exec:                       # webhook 触发的动作必须 exec，不能 shell（见 6.6）
      - sh
      - -c
      - "echo \"webhook triggered at $(date '+%F %T')\""
    execOnWebhook:
      - matchHeaders:
          X-Demo-Token: olive-hook-01

$ curl -s -X POST http://127.0.0.1:8130/webhooks -H 'X-Demo-Token: olive-hook-01' -d '{"hello": "world"}'
OK
$ sleep 2 && curl -s -b cookies.txt -X POST $BASE/GetLogs -H 'Content-Type: application/json' -d '{}' \
    | jq '.logs[0] | {actionTitle, user, exitCode, output}'
{
  "actionTitle": "Webhook 触发任务",
  "user": "webhook",
  "exitCode": 0,
  "output": "webhook triggered at 2026-10-28 13:10:44\n"
}

$ curl -s -X POST http://127.0.0.1:8130/webhooks -H 'X-Demo-Token: wrong-token' -d '{}'
OK     # 状态码仍 200，但日志无新增——错误头静默不触发

exitCode: -1, timedOut: true
output: signal: killed

OliveTin::timeout - this action timed out after 3 seconds. If you need more time for this action, set a longer timeout.

exitCode: -1337
output: template: tpl:1:9: executing "tpl" at <.Names>: can't evaluate field Names in type *tpl.actionTemplateContext

exitCode: -1337, blocked: true
output: ACL check failed. Blocked from executing.

$ NEWVER=3000.21.0    # 换成 releases 页的最新稳定版号
$ curl -LO "https://github.com/OliveTin/OliveTin/releases/download/${NEWVER}/OliveTin-linux-amd64.tar.gz"
$ tar xzf OliveTin-linux-amd64.tar.gz
$ systemctl stop OliveTin
$ cp OliveTin-linux-amd64/OliveTin /usr/local/bin/OliveTin
$ systemctl start OliveTin && journalctl -u OliveTin -n 20 --no-pager   # 确认新版本号启动