![\"\"](\"https:\/\/www.wsisp.com\/helps\/wp-content\/uploads\/2026\/08\/20260814041727-6a7e96d794a0a.png\")
<\/p>\n\u76ee\u5f55<\/p>\n
1\u3001Docker \u4e00\u952e\u542f\u52a8 NapCat<\/p>\n
2\u3001\u767b\u5f55QQ\u5e10\u53f7<\/p>\n
3\u3001\u5f00\u542f HTTP API（\u5b9e\u73b0 Webhook \u8c03\u7528）<\/p>\n
3.1 WebUI \u4fa7\u8fb9\u680f \u2192 \u7f51\u7edc\u914d\u7f6e \u2192 \u65b0\u589e HTTP\u670d\u52a1<\/p>\n
3.2 \u91cd\u542f\u670d\u52a1\u751f\u6548<\/p>\n
4\u3001\u63a5\u53e3\u8c03\u7528\u793a\u4f8b（\u5bf9\u6807\u98de\u4e66 Webhook，POST \u53d1\u6d88\u606f）<\/p>\n
4.1 \u793a\u4f8b 1：Python \u53d1\u9001 QQ \u7fa4\u6d88\u606f（\u8fd0\u7ef4\u544a\u8b66）<\/p>\n
4.2\u00a0\u793a\u4f8b 2：curl \u547d\u4ee4\u76f4\u63a5\u8c03\u7528（\u811a\u672c\u5185\u4f7f\u7528）<\/p>\n
4.3\u00a0\u793a\u4f8b 3：\u53d1\u9001\u79c1\u804a\u6d88\u606f<\/p>\n
5\u3001docker-compose \u6301\u4e45\u5316\u90e8\u7f72（\u63a8\u8350\u957f\u671f\u4f7f\u7528）<\/p>\n
6\u3001\u5e38\u89c1\u95ee\u9898 & \u907f\u5751\u6307\u5357<\/p>\n
7\u3001\u4f18\u7f3a\u70b9\u603b\u7ed3<\/p>\n
8\u3001\u5b8c\u6574\u5c01\u88c5\u4ee3\u7801<\/p>\n
9\u3001cmd\u6d4b\u8bd5<\/p>\n
10\u3001\u66ff\u4ee3\u65b9\u6848\u4f46\u662f\u955c\u50cf\u4e0b\u8f7d\u4e0d\u4e86<\/p>\n
docker run -d \\\\
\n-e NAPCAT_GID=$(id -g) \\\\
\n-e NAPCAT_UID=$(id -u) \\\\
\n-p 3300:3000 \\\\
\n-p 3301:3001 \\\\
\n-p 6099:6099 \\\\
\n–name napcat \\\\
\n–restart=always \\\\
\nmlikiowa\/napcat-docker:latest <\/p>\n
\u7aef\u53e3\u8bf4\u660e： 6099：WebUI \u7ba1\u7406\u540e\u53f0（\u767b\u5f55\u626b\u7801\u3001\u5f00\u542f HTTP \u63a5\u53e3） 3000\/3001：OneBot HTTP\/WS \u63a5\u53e3\u7aef\u53e3<\/p>\n
\u6ce8\u610f：\u4e91\u670d\u52a1\u5668\u9700\u8981\u653e\u884c\u7aef\u53e3：\u5b89\u5168\u7ec4 \/ \u9632\u706b\u5899\u653e\u884c：3000\u30013001\u30016099，\u5426\u5219\u5916\u7f51\u65e0\u6cd5\u8bbf\u95ee\u540e\u53f0\u548c\u8c03\u7528\u63a5\u53e3<\/p>\n<\/p>\n
\u6d4f\u89c8\u5668\u8bbf\u95ee：http:\/\/\u670d\u52a1\u5668IP:6099\/webui \u9ed8\u8ba4\u5bc6\u7801：napcat \u767b\u5f55\u540e\u53f0<\/p>\n
<\/p>\n
docker logs –tail 100 napcat <\/p>\n
![\"\"](\"https:\/\/www.wsisp.com\/helps\/wp-content\/uploads\/2026\/08\/20260814041727-6a7e96d7ccbdc.png\")
<\/p>\n<\/p>\n
\u9009\u62e9\u4e8c\u7ef4\u7801\u767b\u5f55，\u7528\u95f2\u7f6e\u5c0f\u53f7 QQ \u626b\u7801（\u4e0d\u5efa\u8bae\u5e38\u7528\u4e3b\u53f7），\u786e\u8ba4 Linux \u8bbe\u5907\u767b\u5f55<\/p>\n
![\"\"](\"https:\/\/www.wsisp.com\/helps\/wp-content\/uploads\/2026\/08\/20260814041728-6a7e96d812b1b.png\")
<\/p>\n<\/p>\n
\u8fd9\u4e2a\u662f\u4e0d\u9700\u8981\u540e\u53f0\u53bb\u770b\u767b\u5f55\u8d26\u6237\u5bc6\u7801，\u4f60\u76f4\u63a5\u8bbe\u7f6e\u597d,\u6ce8\u610f\u4e0b\u9762\u7684\u5bc6\u7801\u4e0d\u662f\u6211\u7684<\/p>\n
docker rm -f napcat<\/p>\n
docker run -d \\\\
\n-e NAPCAT_GID=$(id -g) \\\\
\n-e NAPCAT_UID=$(id -u) \\\\
\n-e WEBUI_TOKEN="MyNapCat123456" \\\\
\n-e TZ=Asia\/Shanghai \\\\
\n-v \/etc\/localtime:\/etc\/localtime:ro \\\\
\n-v \/opt\/napcat_data:\/app\/.config\/QQ \\\\
\n-v \/opt\/napcat_config:\/app\/napcat\/config \\\\
\n-p 3100:3000 \\\\
\n-p 3101:3001 \\\\
\n-p 6099:6099 \\\\
\n–name napcat \\\\
\n–restart=always \\\\
\nmlikiowa\/napcat-docker:latest <\/p>\n
![\"\"](\"https:\/\/www.wsisp.com\/helps\/wp-content\/uploads\/2026\/08\/20260814041728-6a7e96d85aa40.png\")
<\/p>\n
![\"\"](\"https:\/\/www.wsisp.com\/helps\/wp-content\/uploads\/2026\/08\/20260814041729-6a7e96d911ee4.png\")
<\/p>\n
\u914d\u7f6e\u53c2\u6570：<\/p>\n
docker restart napcat <\/p>\n
\u5bbf\u4e3b\u673a\u7aef\u53e3\u6620\u5c04：3100:3000 \u63a5\u53e3\u57fa\u51c6\u5730\u5740：<\/p>\n
http:\/\/\u670d\u52a1\u5668IP:3100 <\/p>\n
# \u8bf7\u6c42\u5934\u5fc5\u987b\u643a\u5e26\u9274\u6743：Authorization: Bearer \u4f60\u8bbe\u7f6e\u7684AccessToken<\/p>\n
Authorization: Bearer Rjw.kBmuLKNCJXS6 <\/p>\n<\/p>\n
import requests<\/p>\n
base_url = "http:\/\/\u4f60\u7684\u670d\u52a1\u5668IP:3100"
\ntoken = "abc123456" # \u521a\u624d\u81ea\u5b9a\u4e49\u7684AccessToken
\ngroup_id = 123456789 # \u76ee\u6807QQ\u7fa4\u53f7<\/p>\n
headers = {
\n "Authorization": f"Bearer {token}",
\n "Content-Type": "application\/json"
\n}<\/p>\n
# \u53d1\u9001\u6587\u672c\u544a\u8b66
\ndata = {
\n "group_id": group_id,
\n "message": "\u3010\u670d\u52a1\u544a\u8b66\u3011\u8ba2\u5355\u63a5\u53e3\u5f02\u5e38，\u8bf7\u7acb\u5373\u6392\u67e5！"
\n}<\/p>\n
resp = requests.post(f"{base_url}\/send_group_msg", json=data, headers=headers)
\nprint(resp.json()) <\/p>\n
curl -X POST http:\/\/IP:3100\/send_group_msg \\\\
\n-H "Authorization: Bearer abc123456" \\\\
\n-H "Content-Type:application\/json" \\\\
\n-d '{
\n "group_id": 123456789,
\n "message": "\u5b9a\u65f6\u4efb\u52a1\u6267\u884c\u5931\u8d25！"
\n}' <\/p>\n
\u63a5\u53e3\u8def\u5f84 \/send_private_msg，\u53c2\u6570\u66ff\u6362 user_id \u4e3a\u5bf9\u65b9 QQ \u53f7\u5373\u53ef\u3002<\/p>\n<\/p>\n
\u65b0\u5efa docker-compose.yml<\/p>\n
version: "3"
\nservices:
\n napcat:
\n image: mlikiowa\/napcat-docker:latest
\n container_name: napcat
\n restart: always
\n environment:
\n NAPCAT_UID: ${UID}
\n NAPCAT_GID: ${GID}
\n ports:
\n – "3100:3000"
\n – "3101:3001"
\n – "6099:6099"
\n volumes:
\n – .\/qq_data:\/app\/.config\/QQ # \u6301\u4e45\u5316QQ\u767b\u5f55\u4fe1\u606f，\u4e0d\u7528\u91cd\u590d\u626b\u7801 <\/p>\n
\u542f\u52a8\u547d\u4ee4：<\/p>\n
UID=$(id -u) GID=$(id -g) docker compose up -d <\/p>\n
\u4f18\u52bf：\u91cd\u542f\u5bb9\u5668\u4e0d\u4f1a\u4e22\u5931\u767b\u5f55\u72b6\u6001，\u4e0d\u7528\u53cd\u590d\u626b\u7801\u3002<\/p>\n
\u79c1\u6709\u90e8\u7f72，\u65e0\u7b2c\u4e09\u65b9\u5e73\u53f0\u6682\u505c\u670d\u52a1\u3001\u989d\u5ea6\u9650\u5236 \u6807\u51c6 HTTP \u63a5\u53e3，CI\/CD\u3001\u76d1\u63a7\u811a\u672c\u3001\u5b9a\u65f6\u4efb\u52a1\u5747\u53ef\u5bf9\u63a5 \u514d\u8d39\u6c38\u4e45\u81ea\u7528，\u4e00\u6b21\u90e8\u7f72\u957f\u671f\u8fd0\u884c \u274c \u7f3a\u70b9： \u9700\u8981\u4e00\u53f0\u5e38\u9a7b\u670d\u52a1\u5668\u8fd0\u884c\u5bb9\u5668（\u4f4e\u914d\u7f6e\u8f7b\u91cf\u673a\u5668\u5373\u53ef） \u9700\u8981\u81ea\u5907\u95f2\u7f6e QQ \u5c0f\u53f7\u6302\u673a，\u6709\u8f7b\u5fae\u8d26\u53f7\u98ce\u63a7\u98ce\u9669<\/p>\n<\/p>\n
import requests
\nfrom typing import Optional, Dict<\/p>\n
class AlertNotifier:
\n def __init__(
\n self,
\n # \u98de\u4e66\u914d\u7f6e
\n feishu_webhook: str = "",
\n # NapCat QQ\u914d\u7f6e
\n napcat_api: str = "http:\/\/127.0.0.1:3100",
\n napcat_token: str = "",
\n target_group_id: int = 0
\n ):
\n self.feishu_webhook = feishu_webhook
\n self.napcat_api = napcat_api
\n self.napcat_token = napcat_token
\n self.group_id = target_group_id<\/p>\n
def send_feishu(self, title: str, content: str) -> Dict:
\n """\u53d1\u9001\u98de\u4e66\u5361\u7247\u6d88\u606f，\u517c\u5bb9\u539f\u6709\u544a\u8b66\u683c\u5f0f"""
\n payload = {
\n "msg_type": "text",
\n "content": {
\n "text": f"\u3010\u544a\u8b66\u3011{title}\\\\n{content}"
\n }
\n }
\n resp = requests.post(self.feishu_webhook, json=payload, timeout=10)
\n return resp.json()<\/p>\n
def send_qq_group(self, title: str, content: str) -> Dict:
\n """NapCat \u53d1\u9001QQ\u7fa4\u6d88\u606f，\u66ff\u4ee3\u98de\u4e66"""
\n headers = {
\n "Authorization": f"Bearer {self.napcat_token}",
\n "Content-Type": "application\/json"
\n }
\n url = f"{self.napcat_api}\/send_group_msg"
\n payload = {
\n "group_id": self.group_id,
\n "message": f"\u3010\u544a\u8b66\u3011{title}\\\\n{content}"
\n }
\n resp = requests.post(url, json=payload, headers=headers, timeout=10)
\n return resp.json()<\/p>\n
def send_alert(self, title: str, content: str, use_qq: bool = False) -> Dict:
\n """\u7edf\u4e00\u5165\u53e3：\u4e00\u884c\u8c03\u7528，\u81ea\u7531\u5207\u6362\u6e20\u9053"""
\n if use_qq:
\n return self.send_qq_group(title, content)
\n else:
\n return self.send_feishu(title, content)<\/p>\n
# ==================== \u4f7f\u7528\u793a\u4f8b ====================
\nif __name__ == "__main__":
\n notifier = AlertNotifier(
\n # \u586b\u5165\u4f60\u7684\u98de\u4e66webhook
\n feishu_webhook="https:\/\/open.feishu.cn\/open-apis\/bot\/v2\/hook\/xxx",
\n # NapCat \u914d\u7f6e
\n napcat_api="http:\/\/\u4f60\u7684\u670d\u52a1\u5668IP:3100",
\n napcat_token="\u4f60\u5728NapCat\u540e\u53f0\u8bbe\u7f6e\u7684AccessToken",
\n target_group_id=12345678 # QQ\u7fa4\u53f7，\u7eaf\u6570\u5b57
\n )<\/p>\n
# 1. \u539f\u6709\u903b\u8f91：\u53d1\u98de\u4e66（\u65e0\u9700\u6539\u52a8\u539f\u6709\u4e1a\u52a1\u8c03\u7528\u4ee3\u7801）
\n notifier.send_alert(
\n title="\u6570\u636e\u5e93\u8fde\u63a5\u5f02\u5e38",
\n content="\u8ba2\u5355\u5e93\u67e5\u8be2\u8d85\u65f6，\u8017\u65f6>5s，\u8bf7\u8fd0\u7ef4\u68c0\u67e5"
\n )<\/p>\n
# 2. \u5207\u5230QQ\u63a8\u9001，\u53ea\u591a\u52a0\u4e00\u4e2a\u53c2\u6570 use_qq=True
\n notifier.send_alert(
\n title="\u6570\u636e\u5e93\u8fde\u63a5\u5f02\u5e38",
\n content="\u8ba2\u5355\u5e93\u67e5\u8be2\u8d85\u65f6，\u8017\u65f6>5s，\u8bf7\u8fd0\u7ef4\u68c0\u67e5",
\n use_qq=True
\n ) <\/p>\n
curl -X POST http:\/\/199.28.10.135:3100\/send_group_msg ^
\n-H "Authorization: Bearer akn7aHghuGyde1n1" ^
\n-H "Content-Type: application\/json" ^
\n-d "{\\\\"group_id\\\\":797549442,\\\\"message\\\\":\\\\"CMD\u6d4b\u8bd5QQ\u6d88\u606f\u63a8\u9001\u6b63\u5e38\\\\"}" <\/p>\n
docker run -d \\\\
\n –name lagrange-onebot \\\\
\n –restart=always \\\\
\n -e TZ=Asia\/Shanghai \\\\
\n -v \/etc\/localtime:\/etc\/localtime:ro \\\\
\n -v \/etc\/timezone:\/etc\/timezone:ro \\\\
\n -p 3100:8080 \\\\
\n -v \/opt\/lag_data:\/app\/data \\\\
\n lagrangedev\/lagrange.onebot:latest <\/p>\n","protected":false},"excerpt":{"rendered":"
\u76ee\u5f55
\n1\u3001Docker \u4e00\u952e\u542f\u52a8 NapCat
\n2\u3001\u767b\u5f55QQ\u5e10\u53f7
\n3\u3001\u5f00\u542f HTTP API（\u5b9e\u73b0 Webhook \u8c03\u7528）
\n3.1 WebUI \u4fa7\u8fb9\u680f \u2192 \u7f51\u7edc\u914d\u7f6e \u2192 \u65b0\u589e HTTP\u670d\u52a1
\n3.2 \u91cd\u542f\u670d\u52a1\u751f\u6548
\n4\u3001\u63a5\u53e3\u8c03\u7528\u793a\u4f8b（\u5bf9\u6807\u98de\u4e66 Webhook，POST \u53d1\u6d88\u606f）
\n4.1 \u793a\u4f8b 1：Python \u53d1\u9001 QQ \u7fa4\u6d88\u606f（\u8fd0\u7ef4\u544a\u8b66）
\n4.2\u00a0\u793a\u4f8b<\/p>\n","protected":false},"author":2,"featured_media":94410,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[1],"tags":[43,44],"topic":[],"class_list":["post-94415","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-server","tag-43","tag-44"],"yoast_head":"\n