龙虾部署完整指南

🦞 龙虾部署完整指南：从本地开发到生产环境，再到飞书/企微集成

摘要：本文详细介绍龙虾（Lobster）数据采集工具的完整部署流程，涵盖本地环境、服务器生产环境配置，以及飞书、企业微信的机器人集成。无论你是个人开发者还是企业运维，都能找到适合的部署方案。

---

📋 目录

1. 环境选择指南
2. 本地环境安装（开发测试）
3. 服务器环境安装（生产环境）
4. 飞书机器人集成
5. 企业微信集成
6. 配置对比与故障排查
7. 总结

---

环境选择指南

在开始部署之前，先确定你的使用场景：

场景	推荐环境	理由
个人开发测试	本地环境	快速部署，方便调试
小团队使用 (<10 人)	本地环境	成本低，易维护
企业生产环境	服务器环境	高可用，易扩展
需要 24 小时运行	服务器环境	稳定可靠
需要对接 IM 机器人	服务器环境	需要公网访问

核心建议：

• 开发阶段用本地，快速迭代
• 生产环境上服务器，稳定可靠
• IM 集成必须服务器（需要公网 HTTPS）

---

本地环境安装（开发测试）

前置要求

项目	要求
操作系统	Windows 10+ / macOS 10.15+ / Linux
CPU	2 核心+
内存	4GB+
磁盘	10GB 可用空间
Node.js	v18.0+

步骤 1：安装 Node.js

Windows/ macOS 用户： 直接访问 nodejs.org/ 下载 LTS 版本安装。

Linux (Ubuntu/ Debian ) 用户：

curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt-get install -y nodejs

验证安装：

node --version
npm --version

步骤 2：安装龙虾 CLI

# 方式 1：npm 全局安装（推荐）
npm install -g @lobster/cli

# 方式 2：源码安装
git clone https://github.com/lobster/lobster.git
cd lobster
npm install

步骤 3：初始化配置

mkdir -p ~/.lobster
lobster init

配置文件位置：

• Windows: C:\Users\你的用户名.lobster\config.yaml
• macOS/Linux: ~/.lobster/config.yaml

步骤 4：启动服务

lobster start

启动成功后，浏览器访问：http://localhost:8080

本地环境配置示例

environment: local

server:
  port: 8080
  host: 127.0.0.1

database:
  type: sqlite
  path: ~/.lobster/data.db

logging:
  level: debug
  console: true

integrations:
  feishu:
    enabled: false
  wecom:
    enabled: false

---

服务器环境安装（生产环境）

服务器要求

配置项	最低配置	推荐配置
CPU	2 核心	4 核心+
内存	4GB	8GB+
磁盘	20GB SSD	50GB+ SSD
带宽	1Mbps	5Mbps+
系统	Ubuntu 20.04+	Ubuntu 22.04 LTS

步骤 1：服务器准备

ssh root@your-server-ip
sudo apt update && sudo apt upgrade -y
sudo apt install -y curl git wget build-essential

步骤 2：安装 Node.js

curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt-get install -y nodejs
node --version
npm --version

步骤 3：创建专用用户

sudo useradd -m -s /bin/bash lobster
sudo su - lobster

💡 安全提示：生产环境不要用 root 运行应用，创建专用用户更安全。

步骤 4：安装龙虾

npm install -g @lobster/cli
mkdir -p ~/lobster-app
cd ~/lobster-app
lobster init

步骤 5：配置生产环境

编辑配置文件 ~/lobster-app/config.yaml：

environment: production

server:
  port: 8080
  host: 0.0.0.0

https:
  enabled: true
  cert: /etc/ssl/certs/your-domain.crt
  key: /etc/ssl/private/your-domain.key

database:
  type: mysql
  host: localhost
  port: 3306
  user: lobster
  password: your_strong_password
  database: lobster_prod

logging:
  level: info
  file: /var/log/lobster/app.log
  max_size: 100MB
  max_files: 30

security:
  api_key: generate_strong_key_here
  rate_limit: 100

integrations:
  feishu:
    enabled: true
  wecom:
    enabled: true

步骤 6：配置 systemd 系统服务

sudo tee /etc/systemd/system/lobster.service > /dev/null <<'EOF'
[Unit]
Description=Lobster Service
After=network.target

[Service]
Type=simple
User=lobster
WorkingDirectory=/home/lobster/lobster-app
ExecStart=/usr/bin/lobster start
Restart=always
RestartSec=10
Environment=NODE_ENV=production

[Install]
WantedBy=multi-user.target
EOF

sudo systemctl daemon-reload
sudo systemctl enable lobster
sudo systemctl start lobster
sudo systemctl status lobster

步骤 7：配置防火墙

# Ubuntu UFW
sudo ufw allow 8080/tcp
sudo ufw allow 443/tcp
sudo ufw reload

# CentOS firewalld
sudo firewall-cmd --add-port=8080/tcp --permanent
sudo firewall-cmd --add-port=443/tcp --permanent
sudo firewall-cmd --reload

步骤 8：配置 Nginx 反向代理

sudo apt install -y nginx

sudo tee /etc/nginx/sites-available/lobster > /dev/null <<'EOF'
server {
    listen 80;
    server_name your-domain.com;

    location / {
        proxy_pass http://127.0.0.1:8080;
        proxy_http_version 1.1;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    }
}
EOF

sudo ln -s /etc/nginx/sites-available/lobster /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl restart nginx

步骤 9：配置 SSL 证书

sudo apt install -y certbot python3-certbot-nginx
sudo certbot --nginx -d your-domain.com
sudo certbot renew --dry-run

---

飞书机器人集成

前置准备

• ✅ 飞书企业管理员权限
• ✅ 已部署的龙虾服务（需公网访问）
• ✅ HTTPS 域名

步骤 1：创建飞书应用

1. 访问 open.feishu.cn/
2. 登录企业管理员账号
3. 点击"创建应用" → 选择"自建应用"
4. 填写应用信息：应用名称：龙虾助手

步骤 2：配置应用权限

添加以下权限：

• ✅ 机器人
• ✅ 发送消息
• ✅ 接收消息
• ✅ 获取用户信息
• ✅ 获取部门信息

点击"发布"，等待审核（1-2 工作日）

步骤 3：获取应用凭证

App ID: cli_xxxxxxxxxxxxx
App Secret: xxxxxxxxxxxxxxxxxxxx
Verification Token: xxxxxxxxxxxxxxxxxxxx

步骤 4：配置事件订阅

1. 进入"事件订阅"菜单
2. 请求地址：your-domain.com/webhook/fei…
3. 验证 Token：从步骤 3 获取
4. 订阅事件：接收消息、机器人进群、机器人出群

步骤 5：配置龙虾端

integrations:
  feishu:
    enabled: true
    app_id: cli_xxxxxxxxxxxxx
    app_secret: xxxxxxxxxxxxxxxxxxxx
    verification_token: xxxxxxxxxxxxxxxxxxxx
    
    webhook:
      path: /webhook/feishu
      port: 8080
    
    bot:
      name: 龙虾助手
    
    commands:
      - name: /help
        description: 显示帮助信息
      - name: /status
        description: 查看系统状态
      - name: /task
        description: 创建任务

步骤 6：重启服务

lobster restart
# 或
sudo systemctl restart lobster

步骤 7：添加机器人到群聊

1. 打开飞书群聊
2. 点击右上角"..."
3. 选择"添加机器人"
4. 选择"龙虾助手"

步骤 8：测试验证

发送：/help

预期回复：

🦞 龙虾助手 - 帮助菜单

可用命令：
/help    - 显示帮助信息
/status  - 查看系统状态
/task    - 创建任务

---

企业微信集成

前置准备

• ✅ 企业微信管理员权限
• ✅ 已部署的龙虾服务（需公网访问）
• ✅ HTTPS 域名

步骤 1：创建企业微信应用

1. 访问 work.weixin.qq.com/
2. 登录管理员账号
3. 进入"应用管理" → 点击"创建应用"
4. 填写应用信息：应用名称：龙虾助手

步骤 2：获取应用凭证

Corp ID: wwxxxxxxxxxxxxx
Agent ID: 1000001
Secret: xxxxxxxxxxxxxxxxxxxx

步骤 3：配置接收消息

1. 进入"应用管理" → 选择应用

2. 点击"接收消息"设置

3. 填写配置：

   1. URL: your-domain.com/webhook/wec…
   2. Token: 自定义（如：lobster_token_2026）
   3. EncodingAESKey: 点击随机生成

步骤 4：配置龙虾端

integrations:
  wecom:
    enabled: true
    corp_id: wwxxxxxxxxxxxxx
    agent_id: 1000001
    secret: xxxxxxxxxxxxxxxxxxxx
    
    webhook:
      path: /webhook/wecom
      port: 8080
      token: lobster_token_2026
      encoding_aes_key: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
    
    commands:
      - name: 帮助
        description: 显示帮助信息
      - name: 状态
        description: 查看系统状态
      - name: 任务
        description: 创建任务

步骤 5：测试验证

发送：帮助

预期回复：

🦞 龙虾助手 - 帮助菜单

可用命令：
帮助   - 显示帮助信息
状态   - 查看系统状态
任务   - 创建任务

---

配置对比与故障排查

本地环境 vs 服务器环境

配置项	本地环境	服务器环境
监听地址	127.0.0.1	0.0.0.0
端口	8080	8080/443
数据库	SQLite	MySQL/PostgreSQL
日志级别	debug	info
HTTPS	不需要	必须
IM 集成	可选	推荐
系统服务	不需要	systemd
反向代理	不需要	Nginx 推荐

飞书 vs 企业微信

特性	飞书	企业微信
开放平台	open.feishu.cn	work.weixin.qq.com
消息格式	富文本/卡片	文本/卡片
审核时间	1-2 工作日	即时
回调验证	Token 验证	Token + AES
命令前缀	/command	中文命令

常见故障排查

问题 1：飞书回调验证失败

curl -X POST https://your-domain.com/webhook/feishu
openssl s_client -connect your-domain.com:443

问题 2：企业微信消息无法接收

tail -f /var/log/lobster/app.log

问题 3：服务无法启动

sudo systemctl status lobster
sudo journalctl -u lobster -f
sudo lsof -i :8080
lobster config:validate

问题 4：IM 机器人无响应

grep -A 10 "integrations:" ~/lobster-app/config.yaml
tail -f /var/log/lobster/app.log | grep webhook
sudo ufw status

---

快速参考

常用命令

lobster start          # 启动服务
lobster stop           # 停止服务
lobster restart        # 重启服务
lobster status         # 查看状态
lobster logs           # 查看日志
lobster config:validate # 验证配置
lobster backup         # 备份数据
lobster restore        # 恢复数据

配置文件路径

环境	路径
本地	~/.lobster/config.yaml
服务器	~/lobster-app/config.yaml
系统服务	/etc/systemd/system/lobster.service
Nginx	/etc/nginx/sites-available/lobster

日志文件位置

环境	路径
本地	~/.lobster/logs/app.log
服务器	/var/log/lobster/app.log
系统日志	journalctl -u lobster

---

总结

本文介绍了龙虾数据采集工具的完整部署流程：

✅ 本地环境：适合开发测试，快速部署 ✅ 服务器环境：适合生产使用，稳定可靠 ✅ 飞书集成：企业协作，消息通知 ✅ 企微集成：国内企业首选，即时可用

部署建议：

1. 开发阶段用本地环境，快速迭代
2. 生产环境务必上服务器，配置 HTTPS
3. IM 集成需要公网访问，必须服务器部署
4. 生产环境记得配置 systemd 开机自启

---

参考资料

• 📚 龙虾官方文档：docs.lobster.com
• 💬 用户论坛：forum.lobster.com
• 🐛 问题反馈：github.com/lobster/lob…