图片去水印小程序 · 开源部署教程

本项目是一个完整的“图片去水印”解决方案,由微信小程序端和 Go 后端服务组成。它实现了从图片上传、涂抹水印区域到调用 AI 接口去水印的完整流程,并内置了基于微信的内容安全审核机制。

📖 目录

  1. 项目概览
  2. 系统架构与流程
  3. 小程序端配置
  4. Go 服务端部署
  5. – 环境变量配置
  6. – 编译与运行
  7. – systemd 管理
  8. – Nginx 反向代理
  9. 微信内容安全审核配置
  10. 接口文档
  11. 常见问题排查
  12. 安全建议

1. 项目概览

模块 技术栈 说明
小程序端 微信小程序原生开发 负责登录、图片涂抹交互、结果展示与保存
服务端 Go + Gin + JWT 提供鉴权、上游 API 代理、内容审核、多小程序支持

所有敏感信息(AppSecret、API Key)均存储于服务端,小程序端仅通过 JWT 鉴权调用接口。

—

2. 系统架构与流程

小程序端                    Go 服务端                        第三方
   │                           │                              │
   │── wx.login 获取 code ──→ │                              │
   │                           │── code2session (微信) ──→   │
   │←── JWT Token ──────────  │                              │
   │                           │                              │
   │── 上传 image + mask ──→  │                              │
   │  (带 JWT)               │── 内容安全审核 (可选) ──→    │
   │                           │                              │
   │                           │── 携带 API Key 调用去水印 ──→│
   │←── 返回处理结果 ───────  │                              │
   │                           │                              │
   │── 保存图片到相册         │                              │

—

3. 小程序端配置

小程序核心配置文件为 app.js,主要调整后端接口地址和广告开关。

3.1 基础接口地址

globalData: {
  apiBaseUrl: 'https://your-domain.com/vwr/v1',  // 替换为你的后端域名
  // ...
}

3.2 激励广告控制(可选)

adControl: {
  enabled: false,               // true 开启,false 关闭
  adUnitId: 'adunit-xxxxxx',   // 微信广告单元 ID
  singleAdInterval: 2,          // 每处理 2 次触发一次广告
  singleCount: 0,
  rewarded: false
}

3.3 微信公众平台配置

在「开发管理 → 开发设置 → 服务器域名」中添加 request 合法域名:

https://your-domain.com

⚠️ 只填域名,不要带路径。

4. Go 服务端部署

4.1 环境变量(.env)

创建 .env 文件,内容模板如下:

PORT=9123
GIN_MODE=release

JWT_SECRET=请替换为32位以上随机字符串
JWT_ACCESS_TTL=7200
JWT_REFRESH_TTL=2592000

# 多小程序支持,格式:appid1:secret1,appid2:secret2
WX_APPS=wxappid1:secret1,wxappid2:secret2

# 上游去水印 API
UPSTREAM_URL=https://api.zhuimengapi.com/api/v1/remove_watermark
UPSTREAM_API_KEY=your-api-key-here
UPSTREAM_TIMEOUT_SEC=180

ALLOW_ORIGIN=*

# 微信内容安全审核(可选)
MEDIA_CHECK_ENABLED=true
MEDIA_CHECK_PUBLIC_BASE_URL=https://your-domain.com
MEDIA_CHECK_STORAGE_DIR=/path/to/media-check
MEDIA_CHECK_WAIT_SEC=20
MEDIA_CHECK_TIMEOUT_POLICY=block
MEDIA_CHECK_SCENE=1
MEDIA_CHECK_CALLBACK_TOKEN=YourCallbackToken

4.2 编译二进制文件

Linux amd64 编译(在 Windows PowerShell 中):

$env:GOOS="linux"
$env:GOARCH="amd64"
go build -o shuiyin-server-linux-amd64 .

Linux 系统直接编译:

GOOS=linux GOARCH=amd64 go build -o shuiyin-server-linux-amd64 .

4.3 上传并运行

将二进制和 .env 上传到服务器目录,例如 /opt/shuiyin/:

chmod +x /opt/shuiyin/shuiyin-server-linux-amd64
chmod 600 /opt/shuiyin/.env
mkdir -p /opt/shuiyin/logs

4.4 systemd 服务管理

创建服务文件 /etc/systemd/system/shuiyin.service:

[Unit]
Description=Shuiyin Remove Watermark Server
After=network.target

[Service]
Type=simple
User=www
WorkingDirectory=/opt/shuiyin
EnvironmentFile=/opt/shuiyin/.env
ExecStart=/opt/shuiyin/shuiyin-server-linux-amd64
Restart=always
RestartSec=5
LimitNOFILE=65535
StandardOutput=append:/opt/shuiyin/logs/stdout.log
StandardError=append:/opt/shuiyin/logs/stderr.log

[Install]
WantedBy=multi-user.target

启动服务:

systemctl daemon-reload
systemctl enable shuiyin
systemctl start shuiyin
systemctl status shuiyin

查看日志:

journalctl -u shuiyin -f

4.5 Nginx 反向代理(推荐)

server {
    listen 80;
    server_name your-domain.com;

    location / {
        proxy_pass http://127.0.0.1:9123;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;

        proxy_connect_timeout 60s;
        proxy_send_timeout    300s;
        proxy_read_timeout    300s;

        proxy_request_buffering off;
        proxy_buffering off;
        client_max_body_size 20m;
    }
}

—

5. 微信内容安全审核配置

如果你的小程序涉及用户生成内容(UGC),建议开启此功能。

5.1 启用审核

在 .env 中设置:

MEDIA_CHECK_ENABLED=true

5.2 微信公众平台消息推送配置

在「开发管理 → 开发设置 → 消息推送」中配置:

配置项 值
URL https://your-domain.com/vwr/v1/sec/media-check-callback
Token 与 .env 中 MEDIA_CHECK_CALLBACK_TOKEN 一致
EncodingAESKey 随机生成,43 位
消息加密方式 明文模式
数据格式 JSON

⚠️ 当前服务端仅支持明文模式。若需安全模式,需额外实现 AES 解密。

5.3 审核结果处理

  • 20 秒内收到 pass:继续去水印
  • 20 秒内收到 risky/review:拦截请求
  • 超时未收到回调:按 MEDIA_CHECK_TIMEOUT_POLICY 处理(block 为拦截)

审核日志示例:

[MEDIA_CHECK] result appid=wx... openid=oxem... suggest=pass label=100 elapsed=4.09s
[MEDIA_CHECK] result appid=wx... openid=oxem... suggest=risky label=20002 elapsed=2.69s

常见 label 含义:

label 含义
100 正常
20001 时政
20002 色情
20006 违法犯罪
21000 其他

—

6. 接口文档

6.1 登录接口

POST /vwr/v1/auth/login

请求体:

{
  "code": "wx.login 返回的 code",
  "app_id": "你的小程序 AppID"
}

响应:

{
  "code": 200,
  "msg": "ok",
  "data": {
    "token": "jwt_access_token",
    "refresh_token": "jwt_refresh_token",
    "expires_in": 7200
  }
}

6.2 刷新 Token

POST /vwr/v1/auth/refresh

{ "refresh_token": "xxx" }

6.3 去水印

POST /vwr/v1/remove_watermark

Headers:

Authorization: Bearer <token>

请求体:

{
  "image": "原图 base64(可带 data:image/...;base64, 前缀)",
  "mask": "黑白 mask base64(白色=待修复,黑色=保留)"
}

响应:

{
  "code": 200,
  "msg": "ok",
  "data": {
    "result": {
      "image": "处理后图片 base64"
    }
  }
}

6.4 健康检查

GET /healthz

{"code":200,"msg":"ok"}

—

7. 常见问题排查

7.1 真机调试报“网络错误”

原因:微信公众平台未配置 request 合法域名。
解决:添加你的后端域名(不带路径)。

7.2 服务启动报 gin mode unknown: release

原因:.env 文件使用了 Windows 换行符(CRLF)。
解决:

sed -i 's/\r$//' /opt/shuiyin/.env
systemctl restart shuiyin

7.3 内容安全审核回调失败

检查回调 URL 是否可访问:

curl -I https://your-domain.com/vwr/v1/sec/media-check-callback

检查微信下载图片 URL 是否可访问:

curl -I https://your-domain.com/media-check/test.jpg

需返回 200 OK。

7.4 上游接口处理失败

  • 确认 image 和 mask 尺寸一致
  • 检查 UPSTREAM_API_KEY 是否有效
  • 查看日志 journalctl -u shuiyin -f 定位具体错误

8. 安全建议

  • ✅ 所有密钥(AppSecret、API Key)只放在服务端,禁止写进小程序前端。
  • ✅ .env 文件权限设置为 600。
  • ✅ 生产环境务必使用 HTTPS。
  • ✅ 若 AppSecret 或 API Key 曾在网络泄露,请及时重置。
  • ✅ 内容审核回调建议启用 HTTPS 并校验 Token。
  • 🔐 若未来切换到微信回调“安全模式”,需在服务端增加 AES 解密逻辑。