下载：https://download.csdn.net/download/YUJIANYUE/93399432
# Gocha 通用查询系统 · Windows 版（Gocha.exe）
Go 编写的通用查询系统，单文件运行、无安装、无运行时依赖、免服务器等运行环境安装, 双击即可运行。通过 **系统托盘** 常驻， 用浏览器访问 **本机 IP / 局域网 / 公网 + 端口** 即可查询。后台以 SQLite 存储配置， 以 TSV 文件承载数据，支持条件查询、分页、排序、验证码、域名限制与防下载等能力。
> 版本：1.0.3 ｜ 官网：https://chalide.cn/ ｜ 平台：Windows 7 及以上 ｜ 数据库：SQLite（mattn/go-sqlite3）
—
## 一、运行环境
– **单文件 exe，无需安装**：直接把 `Gocha.exe`（64 位）或 `Gocha32.exe`（32 位）放到任意目录双击运行。 – **纯 Go 编译，无外部依赖**：不依赖 .NET / VC++ / Java 等运行时。 – **数据在同目录**：程序会在自身所在目录自动创建 `data/`、`datar/`、`inc/` 等目录， 所有数据库、配置、数据文件都与 exe 放在一起，迁移时整目录复制即可。 – **首次运行**：自动建库建表、写入默认配置，并创建默认管理员账户 **admin / admin888**（建议登录后到“修改密码”中更改）。
> 分发文件说明： > | 文件 | 说明 | > |—|—| > | `Gocha.exe` | 64 位正式版（无控制台窗口，后台常驻） | > | `Gocha32.exe` | 32 位正式版（老旧 32 位系统用） | > > 正式版为 GUI 无窗口模式（双击后只见到系统托盘图标，属正常现象）。
—
## 二、启动与系统托盘
1. 双击 `Gocha.exe`，程序启动后 **右下角系统托盘出现常驻图标**。 2. 默认会 **按配置自动打开浏览器** 进入功能主页（可在设置中关闭）。 3. 托盘图标交互： – **双击图标** → 打开功能主页。 – **右键图标** → 菜单：`功能主页` / `官方网址` / `关于` / `设置` / `重启` / `退出`。 – `重启`：热重启服务（改配置或数据后生效，无需退出）。 – `退出`：停止全部监听并退出程序。 4. 程序运行期间无可见窗口，**托盘存在即服务在运行**；要停止请右键选“退出”，不要强行结束进程。
> 开机自启（可选）：将 `Gocha.exe` 快捷方式放入 > `C:\\Users\\你的用户名\\AppData\\Roaming\\Microsoft\\Windows\\Start Menu\\Programs\\Startup` > 即可开机自动运行（建议用 `Gocha.exe` 而非调试版）。
—
## 三、使用
1. 启动后在浏览器访问主页，默认地址如 `http://localhost:12391/` （局域网/公网下的其它设备用手机或电脑的浏览器访问 `http://<本机IP>:12391/`）。 2. 管理后台：主页右下或“关于/设置”进入(http://localhost:12391/?act=admin )，登录账户 **admin / admin888**。 3. 后台可完成：建立查询列表、关联数据文件、设置查询条件与可见字段、 数据预览、修改密码、验证码开关、站点标题与页脚等。 4. 用户端：在查询页输入条件即可检索，支持分页与排序；空条件按规则处理（需满足条件才返回结果）。 5. 生成的查询网址 / 二维码使用程序实际监听地址，便于直接分享给同网络用户。
—
## 四、设置
### 4.1 运行配置（config.json，位于 exe 同目录）
| 字段 | 说明 | 默认 | |—|—|—| | `ports` | 监听端口，**多端口用列表**，如 `["12391","80"]；留空则默认 12391 起自动遍历空闲端口（123**）** | 空 | | `bind` | 绑定地址，留空 = `0.0.0.0` **泛绑定**（IP/局域网/公网/域名均可访问）；填 `127.0.0.1` 仅本机 | 空 | | `domain` | 域名限制，留空 = 不限制；填写后仅允许该域名（支持 `*` 通配、逗号分隔多域名） | 空 | | `open_browser` | 启动是否自动打开浏览器 | `true` | | `home` | 主页路径 | `/` |
修改 `config.json` 后，右键托盘 → `重启` 即可生效（无需退出重开）。
### 4.2 站点配置（网页后台）
– **站点标题 / 页脚 / 页脚链接**：存于 `inc/sita.json`。 – **提示语**：存于 `inc/tips.json`（按错误码管理，如 域名不符 / 无结果 / 请先登录 等）。 – 以上均在网页后台“设置”中修改并自动保存。
—
## 五、安全能力
网页端内置以下防护，与安卓版一致：
– **数据/目录防下载**：禁止直接访问 `data/`、`inc/`、`upload/`、`datar/` 等受保护目录及其子路径； 禁止下载 `.json` / `.sqlite` / `.db` / `.sql` / `.cache` 等后缀文件（返回 403）。 – **域名限制**：通过 `config.json` 的 `domain` 字段限制可访问的域名，其它域名返回“域名或访问地址不存在”。 – **验证码**：登录与查询可启用 SVG 验证码（无第三方字体依赖，可开关）；验证码位置在输入框前方，点击可刷新。 – **会话管理**：登录写入 `HttpOnly` Cookie，默认有效期 7 天；支持“修改密码”与退出登录。
—
## 六、数据
– 查询数据以 **TSV（制表符分隔、首行表头）文件** 承载，放在 `datar/` 目录下 （示例 `datar/demo.csv` 为演示数据；正式使用建议用 `.tsv` 命名）。 – **编码自动识别**：UTF-8（含 BOM）或 GBK 均会自动转码为 UTF-8。 – **缓存与重载**：数据按 MD5 缓存，文件内容变化后下次访问自动重载，无需重启。 – 每条查询列表在后台关联一个数据文件，定义查询条件列、可见字段、分页与排序方式。 – SQLite 库文件位于 `data/app.db`（配置、列表、账户等结构化数据）。
> 如需从零开始：访问 `http://localhost:12391/?act=inst` 进入安装/环境检查页， > 可写入初始化数据并导入演示数据。
—
## 七、日志与排错
– 程序日志写入 **`gocha.log`**（与 exe 同目录，追加模式）。 GUI 版无控制台窗口，**“双击无反应”时务必先看此文件**定位问题。 – 常见排查： – **启动无托盘 / 无主页**：打开 `gocha.log` 查看是否有端口被占用、权限或数据库初始化失败。 – **端口被占**：默认会自动遍历 `123**` 找空闲端口；或显式在 `config.json` 指定 `ports`。 – **局域网访问不通**：确认 `bind` 为 `0.0.0.0`（默认即泛绑定），并检查系统防火墙是否放行该端口。 – **需要详细输出**：改用 `Gocha-debug.exe`，会弹出控制台实时打印日志。
—
## 八、已知限制
– **单实例演示定位**：会话保存在内存中，程序重启后登录态清空；SQLite 与 TSV 数据持久化于本地目录。 – **Win7 兼容**：正式版为无窗口 GUI，已在 Win7 验证可常驻托盘；若个别环境双击无反应， 先用 `Gocha-debug.exe` 看控制台报错，再按 `gocha.log` 排查。 – **数据位置**：数据库、配置、TSV 数据均在 exe 同目录，删除 `data/`、`datar/`、`inc/` 会清空对应内容； 迁移整机时整目录复制即可保留全部数据。 – 公网暴露请确保配置 **域名限制** 与强密码，避免被随意访问。
—
## 九、与安卓版差异（参考）
| 维度 | Windows 版 | 安卓版 | |—|—|—| | 形态 | 单文件 exe + 系统托盘 | APK（前台服务 + 原生三页） | | 常驻方式 | 托盘常驻（右键退出） | 前台服务 + 通知 + 开机自启 + 电池豁免 | | 数据库 | mattn/go-sqlite3（CGO，体积小） | modernc.org/sqlite（纯 Go，UPX 压缩） | | 配置入口 | 托盘菜单 + 网页设置 + config.json | 原生“设置”页 | | 安装包体积 | 约 2.8 MB（exe） | 约 2.8 MB（APK） |
