# 葵码生成器
在线生成与解析微信葵花码（太阳码），支持中心 Logo、动图、水印与批量生成。
[](https://wx.xbao.fun)
[](https://github.com/AnglerS888/kuima-generator/releases)
[](https://gitee.com/anglers/kuima-generator)
[](https://github.com/AnglerS888/kuima-generator)
[在线演示](https://wx.xbao.fun) · [功能](#功能) · [界面预览](#界面预览) · [安装](#安装) · [怎么用](#怎么用) · [在线更新](#在线更新) · [常见问题](#常见问题) · [关于作者](#关于作者)
输入链接 → 选中心 Logo → 生成并下载
## 在线演示
先看看效果：**
**后台 · 概览**
**后台 · 预设 Logo**
## 安装
三种方式任选其一，装好后访问 `http://服务器IP:8080/`，管理后台在 `/admin`。
首次启动会创建管理员：设置了 `ADMIN_PASSWORD` 就用它，没设置会随机生成并打印在启动日志里。
### 方式一：一键部署（Linux + Docker，推荐）
按服务器所在网络选一条命令执行，脚本会自动拉源码、构建镜像、启动容器，并打印管理员账号密码：
```bash
# 国外服务器
curl -fsSL https://github.com/AnglerS888/kuima-generator/raw/main/bin/deploy.sh -o deploy.sh
bash deploy.sh
# 国内服务器
curl -fsSL https://raw.giteeusercontent.com/anglers/kuima-generator/raw/main/bin/deploy.sh -o deploy.sh
bash deploy.sh
```
再执行一次就是升级。常用参数：
```bash
PORT=9090 bash deploy.sh # 换端口
bash deploy.sh --status # 查看状态和管理员密码
bash deploy.sh --rollback # 回滚到上一版
```
### 方式二：Docker Compose
```bash
git clone https://gitee.com/anglers/kuima-generator.git # 国外用 github.com/AnglerS888/kuima-generator.git
cd kuima-generator
docker compose up -d --build
docker compose logs -f wxcode # 这里能看到随机生成的管理员密码
```
### 方式三：直接运行
需要 Go 1.22+。编译出一个可执行文件即可，数据存本地 SQLite，不用装数据库。
```bash
# 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：
```powershell
go build -ldflags "-X wxcode/internal/config.Version=$(cat VERSION)" -o wxcode.exe ./cmd/wxcode
$env:PORT="8080"; $env:ADMIN_PASSWORD="你的密码"; .\wxcode.exe
```
Windows 也可以直接双击 `wxcode.exe`：默认 8080 端口、数据在程序同级 `data` 目录，管理员密码打印在窗口里。
## 怎么用
1. **生成**：打开首页 → 填内容（网址或文字）→ 选格式和尺寸，可选上传中心 Logo、调颜色 → 点生成并下载。
2. **解析**：切到「解析」页 → 上传截图或拍照 → 得到码里的内容和码型信息。
3. **好友码**：上传微信「二维码名片」截图 → 生成对应的好友太阳码。
4. **批量**：一次填多行内容，批量生成后打包下载。
5. **后台**：`/admin` 里可以管用户与额度、预设 Logo、公告、水印、邀请码 / 卡密、备份导入导出。
6. **接口**：首页「接口」页或 `/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` 重启一次。
## 关于作者
- **作者微信**：`KFC_good` —— 使用问题、部署求助、功能定制都可以加，备注一下「葵码」即可。
- 如果这个项目帮到了你，欢迎请作者喝杯咖啡：
Anglers 的赞赏码