图片去水印小程序 · 开源部署教程
本项目是一个完整的“图片去水印”解决方案,由微信小程序端和 Go 后端服务组成。它实现了从图片上传、涂抹水印区域到调用 AI 接口去水印的完整流程,并内置了基于微信的内容安全审核机制。
📖 目录
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 解密逻辑。