SafeLine MCP Server 的 MCP 客户端 Bearer Token 如何初始化与轮换【免费下载链接】SafeLineSafeLine is a self-hosted WAF(Web Application Firewall) / reverse proxy to protect your web apps from attacks and exploits.项目地址: https://gitcode.com/GitHub_Trending/sa/SafeLine在部署 SafeLine MCP Server 时需要为 MCP 客户端即连接该服务的 AI 客户端启用访问认证先生成一次 Bearer Token 供客户端携带之后在需要作废旧凭据时执行一次显式轮换。这篇文章给出这两步的具体命令、状态文件位置和验证方式。先说清楚范围MCP 客户端认证与下游 SafeLine 实例的 API Token 相互独立。后者按实例存放在token_file指向的文件里只用于 MCP Server 访问 SafeLine 管理 API不会暴露给 MCP 客户端。本文只处理前者的初始化auth init与轮换auth rotate。认证机制Token 只在初始化时显示一次启用 MCP 认证后Token 由crypto/rand生成一个 256-bit 随机值前缀为slmcp_。命令只在执行时把明文打印一次状态文件里只保存 SHA-256 哈希与创建时间文件权限为0600。服务正常重启只会读取该状态不会修改或再次打印 Token实现见 mcp_server/internal/auth/auth.go。客户端之后在每次 MCP 请求中携带该 TokenAuthorization: Bearer slmcp_...其中slmcp_...是auth init/auth rotate输出的实际 Token文档中此处仅为格式示例。内置监听器是明文 HTTPDocker Compose 默认把端口发布在127.0.0.1就是这个静态 Bearer 门闩不被放到网络上明文传输的原因。若要从其他机器访问README 明确要求把端点放在可信的 HTTPS 终止网关之后不要在不受信任的网络上把MCP_PUBLISH_ADDRESS设为0.0.0.0而不做 TLS 终止。准备启用认证并确认状态文件位置Docker Compose 路径下mcp_server/docker-compose.yml容器内状态文件固定为/var/lib/safeline-mcp/auth.json由宿主机${SAFELINE_MCP_STATE_DIR:-./state}目录绑定挂载提供MCP_AUTH_ENABLED默认取宿主机环境变量的值未设置时为false。在mcp_server/目录下操作。先按 mcp_server/README.md 的 Docker 部署流程准备好目录与镜像docker compose build install -d -m 700 /etc/safeline-mcp/secrets /var/lib/safeline-mcp install -m 600 /path/to/production-a.token /etc/safeline-mcp/secrets/production-a.token export SAFELINE_MCP_SECRETS_DIR/etc/safeline-mcp/secrets export SAFELINE_MCP_STATE_DIR/var/lib/safeline-mcp其中/path/to/production-a.token是示例换成你自己每个 SafeLine 实例的管理员 API Token 文件。install命令会创建上述受保护的部署目录700和 Token 文件600——这是 Compose 声明create_host_path: false的前提Compose 拒绝自动创建缺失的绑定挂载路径。若只用./secrets与./state本地开发路径README 要求先以相同权限手动创建这两个目录再运行 Compose。注意两个前提细节状态文件所在目录必须没有 group/other 权限状态文件本身必须是权限0600的普通文件否则Load会拒绝加载并报invalid MCP authentication stateCompose 中的SAFELINE_MCP_STATE_DIR指向的宿主目录就是state的落点初始化前确认该目录存在且权限正确。初始化执行一次 auth init 并保存 Token在同一个 shell 会话里执行export需要延续到后面的docker compose up容器才会在运行态启用认证export MCP_AUTH_ENABLEDtrue docker compose run --rm mcp_server auth init输出示例Token 为随机值此处仅展示文档给出的形式MCP bearer token (shown once; save it now): slmcp_...命令结束后把打印的 Token 保存下来——这是明文唯一可见的时刻。判断初始化是否成功的依据输出中出现一次slmcp_前缀的 Token状态文件已生成宿主机${SAFELINE_MCP_STATE_DIR}目录下的auth.json权限0600内容只有version、token_hash、created_at不含明文再次运行同样的auth init不会重新生成而是提示MCP authentication is already initialized at state file; token was not changed.——init是一次性操作重复执行不改写已有状态。如果启用了认证但状态尚未初始化就启动服务README 明确说明服务器会拒绝启动mcp_server/main.go 中的报错会直接给出该跑的命令例如MCP authentication is enabled but not initialized; run mcp-server auth init --state-file /var/lib/safeline-mcp/auth.json: invalid MCP authentication state: ...之后启动服务并验证客户端侧行为docker compose up -d不带 Token 或携带错误 Token 的 MCP 请求会被中间件拒绝返回401 Unauthorized响应头带WWW-Authenticate: Bearer realmsafeline-mcp见 mcp_server/internal/auth/auth.go 的Middleware。服务重启后日志不会再次出现 Token 明文这与 README「重启只读状态、不改动不打印 Token」的描述一致。可选分支不用 Docker直接用 Go 运行README 给出本地路径的做法先选定一个持久的状态文件再初始化go build -o mcp-server . export MCP_AUTH_ENABLEDtrue export MCP_AUTH_STATE_FILE$PWD/state/auth.json ./mcp-server auth init ./mcp-server --config ./config.yamlauth子命令的完整用法为mcp-server auth init|rotate [--state-file path]不传--state-file时取MCP_AUTH_STATE_FILE环境变量再取不到则用默认路径/var/lib/safeline-mcp/auth.json。轮换auth rotate 并重启服务需要作废旧 Token 时在mcp_server/目录下执行docker compose run --rm mcp_server auth rotaterotate的前提是状态文件已存在且有效它会先Load现有状态成功后才生成新 Token 并整体替换状态文件。它同样只把新 Token 打印一次。与init不同rotate可以重复执行每次都产出一个新值并使旧值失效。README 给出的轮换注意事项轮换在服务重启后才让旧 Token 失效拿到新 Token 后把docker compose up -d重新拉起或重启容器再让客户端改用新 Tokenauth rotate必须作为一次串行化的部署操作执行不支持并发的轮换命令轮换期间客户端会短暂持有两个都不能用的凭据旧的重启后失效、新的还未下发这是一个需要排进变更窗口的动作。限制与边界这套静态 Bearer 门闩面向自托管部署README 明确说明它「不呈现为完整的 MCP OAuth 2.1 实现」不存在全局SAFELINE_API_TOKEN那是下游实例凭据且每个实例各用一份 Token 文件状态文件一旦权限不符合要求如出现 group/other 可读位会被判为无效状态服务会拒绝启动需要恢复到0600的普通文件与0700的目录初始化/轮换命令只负责凭据本身MCP 端点地址、实例映射display_name到instance_id由 mcp_server/config.yaml 与instances配置决定与 Token 管理互不干涉。下一步按 README 的部署顺序走即可保存好auth init输出的 Tokendocker compose up -d启动服务让客户端用Authorization: Bearer token访问POST /mcp。【免费下载链接】SafeLineSafeLine is a self-hosted WAF(Web Application Firewall) / reverse proxy to protect your web apps from attacks and exploits.项目地址: https://gitcode.com/GitHub_Trending/sa/SafeLine创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
SafeLine MCP Server 的 MCP 客户端 Bearer Token 如何初始化与轮换【免费下载链接】SafeLineSafeLine is a self-hosted WAF(Web Application Firewall) / reverse proxy to protect your web apps from attacks and exploits.项目地址: https://gitcode.com/GitHub_Trending/sa/SafeLine在部署 SafeLine MCP Server 时需要为 MCP 客户端即连接该服务的 AI 客户端启用访问认证先生成一次 Bearer Token 供客户端携带之后在需要作废旧凭据时执行一次显式轮换。这篇文章给出这两步的具体命令、状态文件位置和验证方式。先说清楚范围MCP 客户端认证与下游 SafeLine 实例的 API Token 相互独立。后者按实例存放在token_file指向的文件里只用于 MCP Server 访问 SafeLine 管理 API不会暴露给 MCP 客户端。本文只处理前者的初始化auth init与轮换auth rotate。认证机制Token 只在初始化时显示一次启用 MCP 认证后Token 由crypto/rand生成一个 256-bit 随机值前缀为slmcp_。命令只在执行时把明文打印一次状态文件里只保存 SHA-256 哈希与创建时间文件权限为0600。服务正常重启只会读取该状态不会修改或再次打印 Token实现见 mcp_server/internal/auth/auth.go。客户端之后在每次 MCP 请求中携带该 TokenAuthorization: Bearer slmcp_...其中slmcp_...是auth init/auth rotate输出的实际 Token文档中此处仅为格式示例。内置监听器是明文 HTTPDocker Compose 默认把端口发布在127.0.0.1就是这个静态 Bearer 门闩不被放到网络上明文传输的原因。若要从其他机器访问README 明确要求把端点放在可信的 HTTPS 终止网关之后不要在不受信任的网络上把MCP_PUBLISH_ADDRESS设为0.0.0.0而不做 TLS 终止。准备启用认证并确认状态文件位置Docker Compose 路径下mcp_server/docker-compose.yml容器内状态文件固定为/var/lib/safeline-mcp/auth.json由宿主机${SAFELINE_MCP_STATE_DIR:-./state}目录绑定挂载提供MCP_AUTH_ENABLED默认取宿主机环境变量的值未设置时为false。在mcp_server/目录下操作。先按 mcp_server/README.md 的 Docker 部署流程准备好目录与镜像docker compose build install -d -m 700 /etc/safeline-mcp/secrets /var/lib/safeline-mcp install -m 600 /path/to/production-a.token /etc/safeline-mcp/secrets/production-a.token export SAFELINE_MCP_SECRETS_DIR/etc/safeline-mcp/secrets export SAFELINE_MCP_STATE_DIR/var/lib/safeline-mcp其中/path/to/production-a.token是示例换成你自己每个 SafeLine 实例的管理员 API Token 文件。install命令会创建上述受保护的部署目录700和 Token 文件600——这是 Compose 声明create_host_path: false的前提Compose 拒绝自动创建缺失的绑定挂载路径。若只用./secrets与./state本地开发路径README 要求先以相同权限手动创建这两个目录再运行 Compose。注意两个前提细节状态文件所在目录必须没有 group/other 权限状态文件本身必须是权限0600的普通文件否则Load会拒绝加载并报invalid MCP authentication stateCompose 中的SAFELINE_MCP_STATE_DIR指向的宿主目录就是state的落点初始化前确认该目录存在且权限正确。初始化执行一次 auth init 并保存 Token在同一个 shell 会话里执行export需要延续到后面的docker compose up容器才会在运行态启用认证export MCP_AUTH_ENABLEDtrue docker compose run --rm mcp_server auth init输出示例Token 为随机值此处仅展示文档给出的形式MCP bearer token (shown once; save it now): slmcp_...命令结束后把打印的 Token 保存下来——这是明文唯一可见的时刻。判断初始化是否成功的依据输出中出现一次slmcp_前缀的 Token状态文件已生成宿主机${SAFELINE_MCP_STATE_DIR}目录下的auth.json权限0600内容只有version、token_hash、created_at不含明文再次运行同样的auth init不会重新生成而是提示MCP authentication is already initialized at state file; token was not changed.——init是一次性操作重复执行不改写已有状态。如果启用了认证但状态尚未初始化就启动服务README 明确说明服务器会拒绝启动mcp_server/main.go 中的报错会直接给出该跑的命令例如MCP authentication is enabled but not initialized; run mcp-server auth init --state-file /var/lib/safeline-mcp/auth.json: invalid MCP authentication state: ...之后启动服务并验证客户端侧行为docker compose up -d不带 Token 或携带错误 Token 的 MCP 请求会被中间件拒绝返回401 Unauthorized响应头带WWW-Authenticate: Bearer realmsafeline-mcp见 mcp_server/internal/auth/auth.go 的Middleware。服务重启后日志不会再次出现 Token 明文这与 README「重启只读状态、不改动不打印 Token」的描述一致。可选分支不用 Docker直接用 Go 运行README 给出本地路径的做法先选定一个持久的状态文件再初始化go build -o mcp-server . export MCP_AUTH_ENABLEDtrue export MCP_AUTH_STATE_FILE$PWD/state/auth.json ./mcp-server auth init ./mcp-server --config ./config.yamlauth子命令的完整用法为mcp-server auth init|rotate [--state-file path]不传--state-file时取MCP_AUTH_STATE_FILE环境变量再取不到则用默认路径/var/lib/safeline-mcp/auth.json。轮换auth rotate 并重启服务需要作废旧 Token 时在mcp_server/目录下执行docker compose run --rm mcp_server auth rotaterotate的前提是状态文件已存在且有效它会先Load现有状态成功后才生成新 Token 并整体替换状态文件。它同样只把新 Token 打印一次。与init不同rotate可以重复执行每次都产出一个新值并使旧值失效。README 给出的轮换注意事项轮换在服务重启后才让旧 Token 失效拿到新 Token 后把docker compose up -d重新拉起或重启容器再让客户端改用新 Tokenauth rotate必须作为一次串行化的部署操作执行不支持并发的轮换命令轮换期间客户端会短暂持有两个都不能用的凭据旧的重启后失效、新的还未下发这是一个需要排进变更窗口的动作。限制与边界这套静态 Bearer 门闩面向自托管部署README 明确说明它「不呈现为完整的 MCP OAuth 2.1 实现」不存在全局SAFELINE_API_TOKEN那是下游实例凭据且每个实例各用一份 Token 文件状态文件一旦权限不符合要求如出现 group/other 可读位会被判为无效状态服务会拒绝启动需要恢复到0600的普通文件与0700的目录初始化/轮换命令只负责凭据本身MCP 端点地址、实例映射display_name到instance_id由 mcp_server/config.yaml 与instances配置决定与 Token 管理互不干涉。下一步按 README 的部署顺序走即可保存好auth init输出的 Tokendocker compose up -d启动服务让客户端用Authorization: Bearer token访问POST /mcp。【免费下载链接】SafeLineSafeLine is a self-hosted WAF(Web Application Firewall) / reverse proxy to protect your web apps from attacks and exploits.项目地址: https://gitcode.com/GitHub_Trending/sa/SafeLine创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
