分享源码 VX的葵花码/太阳码/圆码 生成、解析

活在浪里

安装
三种方式任选其一，装好后访问 http://服务器IP:8080/，管理后台在 /admin。 首次启动会创建管理员：设置了 ADMIN_PASSWORD 就用它，没设置会随机生成并打印在启动日志里。

方式一：一键部署（Linux + Docker，推荐）
按服务器所在网络选一条命令执行，脚本会自动拉源码、构建镜像、启动容器，并打印管理员账号密码：

curl -fsSL https://github.com/AnglerS888/ku ... /main/bin/deploy.sh -o deploy.sh
bash deploy.sh

再执行一次就是升级。常用参数：

PORT=9090 bash deploy.sh # 换端口
bash deploy.sh --status # 查看状态和管理员密码
bash deploy.sh --rollback # 回滚到上一版
方式二：Docker Compose
git clone github.com/AnglerS888/kuima-generator.git
cd kuima-generator
docker compose up -d --build
docker compose logs -f wxcode # 这里能看到随机生成的管理员密码
方式三：直接运行
需要 Go 1.22+。编译出一个可执行文件即可，数据存本地 SQLite，不用装数据库。

# Linux
CGO_ENABLED=0 go build -ldflags \\\\\\\\\\\\\\\"-X wxcode/internal/config.Version=$(cat VERSION)\\\\\\\\\\\\\\\" -o wxcode ./cmd/wxcode
PORT=8080 DATA_DIR=./data ADMIN_USER=admin ADMIN_PASSWORD=\\\\\\\\\\\\\\\'你的密码\\\\\\\\\\\\\\\' ./wxcode
Windows 用 PowerShell：

go build -ldflags\\\\\\\\\\\\\\\"-X wxcode/internal/config.Version=$(cat VERSION)\\\\\\\\\\\\\\\"-o wxcode.exe ./cmd/wxcode
$envORT=\\\\\\\\\\\\\\\"8080\\\\\\\\\\\\\\\"; $env:ADMIN_PASSWORD=\\\\\\\\\\\\\\\"你的密码\\\\\\\\\\\\\\\"; .\\\\\\\\\\\\\\\\wxcode.exe
Windows 也可以直接双击 wxcode.exe：默认 8080 端口、数据在程序同级 data 目录，管理员密码打印在窗口里。

怎么用
生成
打开首页 → 填内容（网址或文字）→ 选格式和尺寸，可选上传中心 Logo、调颜色 → 点生成并下载。
解析
切到「解析」页 → 上传截图或拍照 → 得到码里的内容和码型信息。
好友码
上传微信「二维码名片」截图 → 生成对应的好友太阳码。
批量
一次填多行内容，批量生成后打包下载。
后台
/admin 里可以管用户与额度、预设 Logo、公告、水印、邀请码 / 卡密、备份导入导出。
接口
首页「接口」页或 /api/docs.md 有在线文档，可直接复制 curl 示例。
常用配置
变量
说明
PORT
监听端口，默认 8080
DATA_DIR
数据目录，默认 ./data（数据库文件在这里）
ADMIN_USER
/ ADMIN_PASSWORD
首次启动创建的管理员账号 / 密码
ADMIN_RESET_PASSWORD=1
忘记密码时，配合 ADMIN_PASSWORD 重启一次即可重置
在线更新
后台「概览 → 版本与更新」：

有新版本时页面会直接提示，点「更新到 vX」即可，升级进度和报错都会显示在页面上，完成后自动刷新。
版本号没变、但想重新拉一遍远端程序时，点「强制更新」。
用 Docker 部署的话，建议还是用 bash deploy.sh 升级（重建镜像更干净）。
常见问题
扫出来只显示文字，不跳转？ 葵花码承载的是内容本身，微信只对 http(s) 开头的网址跳转；要扫码打开小程序，需要用微信后台签发的小程序码。

数据在哪？怎么备份或迁移？ DATA_DIR 下的 wxcode.db。停机后拷走这个文件（或整个 data 目录），放到新机器同样的位置启动即可，账号、额度、记录、预设 Logo 都在。后台也能直接导出 / 导入。

忘记管理员密码？ 带 ADMIN_RESET_PASSWORD=1 和新的 ADMIN_PASSWORD 重启一次。

https://pan.quark.cn/s/831ad0b5f205