03 / FIELD NOTES

看谁占用了 8080

CrowdSec 本地 API 起不来时，先查谁占着 8080。

只读crowdsec 8080 ss

为什么这样选

新机器上 CrowdSec 起不来，常见是 8080 已被占用，不是安装坏了。先用 ss 看，再去改三处 YAML。

什么时候用

CrowdSec 本地 API 起不来，因为 127.0.0.1:8080 已被占用。

什么时候别用

这里只列出监听进程。改 LAPI 端口要同时改三处配置。

前置条件

有 ss（iproute2）
有权限看到进程名

步骤

列出占用 8080 的进程

只读

ss -lptn 'sport = :8080'

跑完应看到: 看到进程名和 pid；端口空闲则没有行。

会改什么

只读。默认 127.0.0.1:8080 写在 config.yaml、local_api_credentials.yaml 和防火墙 bouncer 配置里。三处一起改，再重启两个服务。

{
  "slug": "crowdsec-8080",
  "risk": "safe",
  "tags": [
    "crowdsec",
    "8080",
    "ss"
  ],
  "updated": "2026-10-28",
  "pathIndex": null,
  "why": "新机器上 CrowdSec 起不来，常见是 8080 已被占用，不是安装坏了。先用 ss 看，再去改三处 YAML。",
  "steps": [
    {
      "command": "ss -lptn 'sport = :8080'",
      "risk": "safe"
    }
  ]
}