这个项目本身是一个中文敏感词库，要把它“运行”起来，主要有两种方式：一是把词库文件集成到自己的程序里，二是直接利用项目里自带的敏感词检测服务。我帮你把这两种方式在 Linux 服务器上的操作方法都梳理好了：

### 1. 通过 Git 克隆代码
首先，在 Linux 服务器上获取项目文件，并切换 dev 分支：
```bash
git clone https://github.com/konsheng/Sensitive-lexicon.git
cd Sensitive-lexicon
git checkout dev
```
如果 git checkout dev 失败，是因为默认克隆下来的是 master 分支，在克隆时加上 -b dev 参数可以直接下载 dev 分支：

```bash
git clone -b dev https://github.com/konsheng/Sensitive-lexicon.git
cd Sensitive-lexicon
```
### 2. 查看项目内容
```bash
ls -l
```
主要会看到这几个目录：

```bash
Vocabulary/：未经整理的原始词汇库。

Organized/：经过整理的分类词汇库。

ThirdPartyCompatibleFormats/：为第三方平台提供的兼容格式。

cmd/server/：用 Go 语言写的 HTTP 敏感词检测服务。

internal/：服务内部实现逻辑。

Dockerfile / .dockerignore：Docker 镜像构建相关文件。
```
### 3.运行 HTTP 检测服务（使用 Go 语言）

项目自带了一个用 Go 语言编写的轻量 HTTP 服务，可以用来做敏感词检测。这种方式不需要你自己实现算法，开箱即用。

准备工作：在 Linux 服务器上安装 Go 1.16 或更高版本。可以执行以下命令检查：

```bash
go version
```
如果未安装，可以到 Go 官网 下载对应版本。

具体操作步骤如下：

设置环境变量并编译

在项目根目录下，参考以下命令设置环境变量、下载依赖并编译：

```bash
# 设置端口和词库目录
export PORT="8080"
export LEXICON_DIR="Vocabulary"
export FUZZY_MAX_DISTANCE="1"
```
下载 Go 模块依赖并编译可执行文件
```bash
go mod tidy
go build -o bin/server ./cmd/server
```
运行服务,编译成功后，运行生成的可执行文件：

```bash
./bin/server
```
启动成功后，你会看到类似这样的日志，表示服务在 8080 端口上监听：

```text
Server started on port 8080
```
测试服务
健康检查 (GET /health)：

```bash
curl http://localhost:8080/health
```
敏感词检测 (POST /detect)：
发送一个 JSON 请求来检测文本，其中 enable_fuzzy 参数用于开启模糊匹配：

```bash
curl -X POST http://localhost:8080/detect \
  -H "Content-Type: application/json" \
  -d '{"text": "待检测的文本内容", "enable_fuzzy": true}'
```
重新加载词库 (POST /reload)：
如果词库文件有更新，无需重启服务，发送这个请求即可热加载：

```bash
curl -X POST http://localhost:8080/reload
```
需要注意，Vocabulary 目录里的文件是 .txt 格式，每行一个词，但可能存在一些特殊字符或 BOM（Byte Order Mark）。如果遇到解析问题，可以用 dos2unix、sed 等命令对文件进行预处理。

### 4. 使用 Docker 运行（推荐）
为了更快速、更优雅地部署，项目提供了 Docker 支持，可以免去配置 Go 环境的麻烦。

确保系统安装了 Docker。可以执行以下命令检查：

```bash
docker --version
```
构建镜像：

```bash
docker build -t sensitive-lexicon .
```
运行容器：

```bash
docker run -d -p 18080:8080 -e PORT=8080 -e LEXICON_DIR=Vocabulary sensitive-lexicon
```
启动后，同样可以通过 http://localhost:18080 来访问服务。

修改 Dockerfile 使用替代镜像
如果修改 Docker 配置不生效，或者你希望快速解决，可以直接修改项目的 Dockerfile，使用一个已经同步好的国内镜像替代。

在项目根目录下找到 Dockerfile 并打开：

```bash
vim Dockerfile
```


构建时报错go: github.com/andybalholm/brotli@v1.0.5: Get "https://proxy.golang.org/...": i/o timeout
找到以 FROM gcr.io/distroless/static:nonroot 开头的行，将其替换为：

```dockerfile
FROM oamdev/gcr.io-distroless-static:nonroot
```
保存文件后，重新执行 docker build 命令。

这个 oamdev/gcr.io-distroless-static:nonroot 镜像的功能和原版一致，可以放心使用。


### 新增：敏感词检测服务的Nginx反向代理
    location /sensitive/ {
        # 重写路径：将 /sensitive/detect 转为 /detect
        rewrite ^/sensitive/(.*)$ /$1 break;
        proxy_pass http://127.0.0.1:18080;
        include /etc/nginx/snippets/proxy-common.conf;
    }



Sensitive-lexicon敏感词检测服务

# OpenClaw Gateway 在 WSL 环境中 systemd 用户服务故障排查手册


当openclaw安装成功后，想使用systemctl --user管理服务时，就出现了坑爹的一幕

```shell
cool@DESKTOP-UH68ET8:~$ systemctl --user enable openclaw-gateway.service
Failed to connect to bus: No such file or directory
```

# 1.诊断当前环境
```shell
1. 检查用户级的 systemd 运行时目录是否存在
ls -ld /run/user/$(id -u)

2. 查看 XDG_RUNTIME_DIR 环境变量是否设置正确
echo $XDG_RUNTIME_DIR

3. 直接尝试查看用户服务状态（看看是不是一样的报错）
systemctl --user status

4. 检查系统是否安装了用户会话必需的 D-Bus 模块
dpkg -l | grep dbus-user-session

5.检查 /etc/wsl.conf 配置，确保包含 systemd=true
cat /etc/wsl.conf

```
需要注意的
- 第一条命令如果返回 No such file or directory，说明系统根本没有为你当前的用户创建运行时目录，这是用户服务无法启动的根本原因之一 。

- 第二条命令应该输出类似 /run/user/1000 的路径，并且这个路径应该和第一条命令的路径一致。若没有可以执行手动设置命令 export XDG_RUNTIME_DIR=/run/user/$(id -u)；

- 第四条命令用于确认系统是否安装了 dbus-user-session 包。这个包对于用户级 D-Bus 的支持至关重要。如果 dbus-user-session 没有安装：请使用以下命令安装，然后重启系统以确保所有组件正确加载
```shell
sudo apt install dbus-user-session
```

# 2.手动重启 systemd 用户实例

```shell
sudo systemctl restart user@$(id -u).service
```
重启成功后验证是否生效

```shell
systemctl --user status
```

openclaw的systemd问题

## 在服务端安装完 OpenClaw 后，让小龙虾查找网页，截图等操作无法执行，接下来一步一步带你安装
其实 OpenClaw 的浏览器组件在无桌面环境（Headless）下需要特定的‘打开方式’
1. 我们需要从谷歌下载chrome软件包，每个系统安装chrome的软件包不一样，大家需要根据系统进行下载

Debian/Ubuntu (.deb):
```shell
# 下载浏览器
wget https://dl.google.com/linux/direct/google-chrome-stable_current_amd64.deb

# 安装浏览器
sudo dpkg -i google-chrome-stable_current_amd64.deb

# 更新软件源
sudo apt update

# 安装Noto字体核心包
sudo apt install fonts-noto fonts-noto-cjk fonts-noto-color-emoji

# 刷新字体缓存
fc-cache -fv
```
或Centos(.rpm)安装包:
```shell
wget https://dl.google.com/linux/direct/google-chrome-stable_current_x86_64.rpm

# 安装依赖包
yum install -y liberation-fonts
yum install -y xdg-utils

#安装字体，防止浏览器文字加载不出来
yum install -y google-noto-sans-cjk-fonts

# 安装google包 ，注意：这里用 yum localinstall，它会自动补齐依赖
yum localinstall -y ./google-chrome-stable_current_x86_64.rpm

```
2. 配置Openclaw
```shell
# 设置默认使用 openclaw 模式
openclaw config set browser.defaultProfile "openclaw"

# 再次确认无桌面模式开启
openclaw config set browser.headless true

# 2. 强制开启 NoSandbox （否则以root用户运行的openclaw，Chrome 出于安全策略拒绝启动）
openclaw config set browser.noSandbox true

# 确认chrome路径
openclaw config set browser.executablePath "/usr/bin/google-chrome"
```
3. 重启Openclaw
```shell
openclaw gateway restart
```
4. 启动浏览器
```shell
openclaw browser start
```
5. 查看浏览器配置,running: true
```shell
openclaw browser status
```

OpenClaw安装Google Chrom浏览器



:::info{title=""}
在 Ubuntu 24.04 LTS 上，虽然可以通过 Ubuntu 的官方仓库直接安装 Docker，但是这种方法通常无法获取到最新的 Docker 版本，而且安全更新也可能延迟。

因此，推荐从 Docker 的官方仓库进行安装，确保可以用上最新版本并和自动更新。
:::
1. 更新软件包
```shell
sudo apt update
``` 
2. 添加 Docker 仓库所需的前置软件包
```shell
sudo apt install apt-transport-https curl
```
3. 下载并导入 Docker 官方的 GPG 密钥
```shell
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
```
4. Docker官方仓库添加到 Ubuntu 24.04 LTS 的软件源列表
```shell
echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
```
5. 更新软件包
```shell
sudo apt update
```
6. 安装最新版本的 Docker，包括 Docker 引擎及其相关组件
```shell
sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
```
7. 检查Docker运行状态
```shell
sudo systemctl is-active docker
```
8. 替换国内源
```shell
sudo vim /etc/docker/daemon.json
```
```shell
{
  "registry-mirrors": [
    "https://docker.1ms.run",
    "https://docker-0.unsee.tech",
    "https://docker.m.daocloud.io",
    "https://docker.1panel.live"
  ]
}
```
9. 重启 Docker 服务：保存配置文件并重启 Docker 服务以应用更改
```shell
sudo systemctl daemon-reload
```
```shell
sudo systemctl restart docker
```
10. 将当前登录的用户添加到 docker 组，以便以非 root 用户身份运行 Docker 命令
```shell
sudo usermod -aG docker ${USER}
```

在Ubuntu 24.04 LTS 上安装 Docker

1、下载浏览器安装包
```shell
wget https://dl.google.com/linux/direct/google-chrome-stable_current_amd64.deb
```
2、执行安装（WSL中需sudo权限）
```shell
sudo dpkg -i google-chrome-stable_current_amd64.deb
```
3、如遇依赖问题，执行
```shell
sudo apt install -f
```