离线安装教程

Windows 桌面版:先装 MySQL,再装 GoBooks

图文说明桌面离线版安装步骤,包括环境要求、GoBooks 安装包、MySQL 8.0 配置与首次配置向导。

本文面向首次部署 GoBooks 桌面离线版 的用户。请按顺序完成:确认环境 → 安装 GoBooks → 安装并启动 MySQL 8.0 → 运行配置向导。也可先前往 软件下载 获取安装包。

一、系统环境要求

  • 操作系统:Windows 10 / 11 或 Windows Server 2019 及以上(64 位)
  • 安装位置:必须安装在 C 盘(例如 C:\Program Files\GoBooks)
  • 数据库:MySQL 8.0 或更高版本(配置向导仅支持 MySQL;MariaDB 不在官方支持列表)
  • 浏览器:Microsoft Edge 或 Google Chrome(最新版)
  • 建议配置:4 核 CPU、8 GB 内存、50 GB 可用磁盘空间
  • 网络:本机访问 127.0.0.1:8080;无需公网即可使用核心财务功能
GoBooks 离线安装环境要求示意图
环境要求一览:Windows 64 位 + MySQL 8.0+ + C 盘安装路径

二、安装 GoBooks

  1. 双击 GoBooks-Setup.exe;若出现 UAC 提示,请选择「是」(需管理员权限)。
  2. 安装路径保持默认 C:\Program Files\GoBooks,不要改到其他盘符。
  3. 等待文件复制与 Windows Defender 排除项配置完成。
  4. 安装结束时可勾选「查看安装说明」「安装完成后启动 GoBooks」。
  5. 开始菜单会出现:GoBooks、GoBooks 配置向导、安装说明。
运行 GoBooks 安装程序示意图
运行安装程序,路径保持 C:\Program Files\GoBooks

若 Windows 安全中心误报并隔离 gobooks.exe:打开「病毒和威胁防护」→「保护历史记录」→ 还原相关项,并在排除项中添加 C:\Program Files\GoBooks。

三、安装 MySQL 8.0(首次部署必做)

GoBooks 业务数据存放在 MySQL 中。请先在本机(或局域网服务器)准备好 MySQL 8.0+,再运行配置向导。以下以 Windows 官方安装包为例。

下载地址:MySQL Installer for Windows

步骤 1:下载 MySQL Installer

访问 MySQL 官网下载页面,下载 mysql-installer-community(在线安装器或完整离线包均可)。

下载 MySQL Installer 示意图
下载 MySQL Installer Community(Windows)

步骤 2:运行安装程序

双击 mysql-installer-community-*.msi。安装类型建议:

  • Server only — 仅数据库服务(推荐生产环境)
  • Developer Default — 含 Workbench 等工具(适合首次试用)

产品版本请选择 MySQL Server 8.0.x(或 8.4 LTS)。

步骤 3:配置 MySQL Server

  • Type and Networking:Port 保持 3306;仅本机使用时可取消防火墙端口放行。
  • Accounts and Roles:为 root 设置强密码并牢记;可选新建 gobooks 专用账户并授予建库权限。
  • Windows Service:勾选配置为 Windows 服务,服务名默认 MySQL80,勾选开机自动启动。
  • 完成 Apply Configuration,显示 Successful 即可。
配置端口 3306、root 密码,并启用 MySQL80 Windows 服务

步骤 4:确认 MySQL 已启动

按 Win+R,输入 services.msc,找到 MySQL80(或 MySQL),状态应为「正在运行」。也可在命令提示符执行 mysql -u root -p,能进入 mysql> 提示符即表示正常。

services.msc 中 MySQL80 正在运行示意图
在服务管理中确认 MySQL80 状态为「正在运行」

步骤 5:(可选)创建专用数据库用户

CREATE USER 'gobooks'@'localhost' IDENTIFIED BY '您的强密码';
CREATE USER 'gobooks'@'127.0.0.1' IDENTIFIED BY '您的强密码';
GRANT ALL PRIVILEGES ON *.* TO 'gobooks'@'localhost';
GRANT ALL PRIVILEGES ON *.* TO 'gobooks'@'127.0.0.1';
FLUSH PRIVILEGES;

配置向导中可使用 gobooks 账户代替 root(权限需包含建库)。若 MySQL 在其他服务器:主机填内网 IP,端口 3306,并授权对应网段用户。

四、首次配置向导

MySQL 就绪后启动 GoBooks,浏览器将打开:

http://127.0.0.1:8080/app/setup

若未自动打开,请从开始菜单运行「GoBooks」或「GoBooks 配置向导」。

GoBooks 配置向导填写数据库连接示意图
在配置向导中填写 MySQL 连接并测试成功后再继续
  1. 数据库连接:类型 MySQL;主机 127.0.0.1(或服务器 IP);端口 3306;用户名 root 或 gobooks;填写密码后点击「测试连接」。
  2. 业务库:向导将自动创建业务数据库并初始化表结构。
  3. 管理员账户:设置登录名、邮箱与强密码(请勿使用弱口令)。
  4. 公司与账套:填写公司名称、简称、行业等,完成首账套创建。

配置成功后,使用管理员账户登录 http://127.0.0.1:8080/。

五、日常使用

  • 启动:桌面或开始菜单「GoBooks」图标
  • 托盘:任务栏右下角图标;左键打开浏览器,右键可退出
  • 配置与日志目录:%LOCALAPPDATA%\GoBooks\

六、卸载说明

通过「设置 → 应用 → GoBooks」卸载。卸载会停止相关进程;MySQL 数据库不会自动删除,需自行备份后手动处理。

七、需要帮助?

安装问题请邮件 support@xdawn.cn,并尽量附上:安装包版本、%LOCALAPPDATA%\GoBooks\post-install.log、MySQL 版本与连接方式、配置向导报错截图。

也可返回 定价页 了解套餐,或前往 软件下载 获取最新安装包。