Appearance
发发记账独立部署版升级更新系统方法
我们的记账系统包括程序文件和记账数据两类文件。
记账数据：是账单图片文件夹、ssl证书文件、数据库、配置文件。这部分文件不随着系统更新。
程序文件：除记账数据以外的文件，系统更新时候会更改。
升级原理：保留原始记账数据（这是我们记账数据不能覆盖），升级覆盖程序文件即可。
官方发布升级时，我们会在用户登录web页面或者app时推送升级通知，建议您升级新版本，如不升级新版也不影响当前版本使用。
独立部署app升级请直接在 https://www.88jizhang.com/private/gongneng.html 扫描下载最新版
关于2025年11月15日前旧版本升级特别说明
由于系统构架升级，如果你使用的是2025年11月15日前的版本，升级前需要手动调整一下持久化文件夹文件目录。再进行升级。
调整方法：新建一个data文件夹，需将原持久化文件夹jizhang.db 和setting.json文件移动到data目录下面。
调整前目录结构：
code
.88jizhang
├─ zhangdanimages/ # 📁 账单相册在此文件夹里面（是个空文件夹后期存放账单图片）
├─ https/ # 📁 ssl证书存放文件夹(里面有cert.pem和key.pem两个文件)
│─ jizhang.db # 🏠 数据库文件
│─ setting.json # 🔧 配置文件（用户注册密钥等可自行修改）
└─ .... # 用户自行添加的其他文件调整后目录结构：
code
.88jizhang
├─ zhangdanimages/ # 📁 账单相册在此文件夹里面（是个空文件夹后期存放账单图片）
├─ https/ # 📁 ssl证书存放文件夹(里面有cert.pem和key.pem两个文件)
├─ data/ # 📁 数据文件目录
│ ├─ jizhang.db # 🏠 数据库文件
│ └─ setting.json # 🔧 配置文件（用户注册密钥等可自行修改
└─ .... # 用户自行添加的其他文件docker、NAS升级安装方法（映射储存空间模式）
有我们的记账数据文件（账单图片文件夹、ssl证书文件、数据库、配置文件）已经映射到宿主机上。所以我们升级至直接升级容器镜像即可。
1-备份原宿主机文件
原来我们的数据持久化映射文件夹目录有以下文件：
code
.88jizhang
├─ zhangdanimages/ # 📁 账单相册在此文件夹里面（是个空文件夹后期存放账单图片）
├─ https/ # 📁 ssl证书存放文件夹(里面有cert.pem和key.pem两个文件)
├─ data/ # 📁 数据文件目录
│ ├─ jizhang.db # 🏠 数据库文件
│ └─ setting.json # 🔧 配置文件（用户注册密钥等可自行修改
└─ .... # 用户自行添加的其他文件对上面文件夹整体备份。
温馨提示
如果上次安装过程中容器和宿主机对记账持久化文件夹未映射成功，则记账数据会储存在容器里面，升级过程中容器会被删除会导致记账数据丢失。 那么升级前，我们先检查一下宿主机（如群晖NAS的File Station）中的持久化vip88jizhang文件夹是否映射成功，是否真正储存了记账数据。确认宿主机映射的持久化文件夹数据为记账数据后再进行升级。
升级前，请确认持久化目录是否真正有效。查看jizhang.db文件的修改日期是否为你最后一次记账日期。 查看zhangdanimages文件夹里面是否有储存的账单图片。 通过该方式可以确认该持久化88jizhang文件夹有效。
2-删除原容器
在docker里面删除原88jizhang容器（这时只是容器没了，上面宿主机的映射目录中的记账数据仍在）。
3-下载最新容器镜像，重新配置映射文件夹
在 https://www.88jizhang.com/private/gongneng.html 找到最新的镜像文件地址
将下面的docker run命令修改后，运行：
code
docker run -d \
--name 88jizhang \ # 容器命名为88jizhang
-p 5188:5188 \ # 宿主机5188端口(冒号左边)映射容器5188端口(冒号右边)
-p 5199:5199 \ # 宿主机5199端口(冒号左边)映射容器5199端口(冒号右边)
-v /home/zhangsan/docker/88jizhang/data:/app/data \ # 映射数据文件夹
-v /home/zhangsan/docker/88jizhang/https:/app/https \ # 映射SSL证书目录
-v /home/zhangsan/docker/88jizhang/zhangdanimages :/app/zhangbenpicture/zhangdan-picture \ # 映射账单相册存储目录
-e TZ=Asia/Shanghai \ # 添加时区配置
--restart always \ # 添加自动重启策略
crpi-btxs8xhps2iaw65e.cn-hangzhou.personal.cr.aliyuncs.com/88jizhang/88jizhang:v1.0.13这里修改重点是：将/home/zhangsan/docker/88jizhang目录替换为宿主机的88jizhang目录 可以参照
然后重新启动容器。
温馨提示
如果设置了docker-compose.yml文件，升级将更加简单。直接删除原容器，重新利用原docker-compose.yml文件（注意修改镜像版本）拉取镜像并新建容器即可。
windows升级安装方法
1-下载最新安装文件
去 https://www.88jizhang.com/private/gongneng.html 页面下载最新版windows平台安装文件。
官网下载对应运行平台最新安装文件，解压文件，显示以下文件内容：
目录
.
├─ node_modules/ # 📁 项目运行必须包含的依赖文件
├─ zhangbenpicture/ # 📁 账单图片文件夹及web界面的一些页面
├─ https/ # 📁 ssl证书存放文件夹
├─ data/ # 📁 数据文件目录
│ ├─ jizhang.db # 🏠 数据库文件
│ └─ setting.json # 🔧 配置文件（用户注册密钥等可自行修改
│─ 点击启动独立部署版.exe # 🚀 快速启动文件
└─ .... # 其他项目文件(如安装说明等文件)2-删除最新版包装包记账数据文件
删除最新安装包里面的data文件夹和https文件夹（因为这个文件夹存记账数据、配置文件和ssl证书文件，所以要删除新安装包里面的数据文件）。
删除后安装包剩余文件如下：
目录
.
├─ node_modules/ # 📁 项目运行必须包含的依赖文件
├─ zhangbenpicture/ # 📁 账单图片文件夹及web界面的一些页面
│─ 点击启动独立部署版.exe # 🚀 快速启动文件
└─ .... # 其他项目文件(如安装说明等文件)3-升级文件覆盖原文件
将最新安装包的剩余文件全部覆盖原来服务端里面的文件或者文件夹。 注意采用完全覆盖方式。
4-重启系统
重新运行“点击启动独立部署版.exe”文件。
特别注意
避免升级失败，升级前请先备份整个服务端文件夹后再升级。
linux（非docker安装）升级方法
去 https://www.88jizhang.com/private/gongneng.html 页面下载最新版linux平台安装文件。
官网下载对应运行平台最新安装文件，解压文件，显示以下文件内容：
目录
.
├─ node_modules/ # 📁 项目运行必须包含的依赖文件
├─ zhangbenpicture/ # 📁 账单图片文件夹及web界面的一些页面
├─ https/ # 📁 ssl证书存放文件夹
├─ data/ # 📁 数据文件目录
│ ├─ jizhang.db # 🏠 数据库文件
│ └─ setting.json # 🔧 配置文件（用户注册密钥等可自行修改
│─ appstart # 🚀 快速启动文件
└─ .... # 其他项目文件(如安装说明等文件)2-删除最新版包装包记账数据文件
删除最新安装包里面的data文件夹和https文件夹（因为这个文件夹存记账数据、配置文件和ssl证书文件，所以要删除新安装包里面的数据文件）。
删除后安装包剩余文件如下：
目录
.
├─ node_modules/ # 📁 项目运行必须包含的依赖文件
├─ zhangbenpicture/ # 📁 账单图片文件夹及web界面的一些页面
│─ appstart # 🚀 快速启动文件
└─ .... # 其他项目文件(如安装说明等文件)3-升级文件覆盖原文件
将最新安装包的剩余文件全部覆盖原来服务端里面的文件或者文件夹。
4-重启系统
运行终端,重新运行“appstart”文件。
特别注意
避免升级失败，升级前请先备份整个服务端文件夹后再升级。
windows和linux(非docker)数据迁移方式
如果更换电脑、服务器等，可以将整个记账系统完整且无损的迁移。
迁移方式，直接复制记账服务端的所有文件及文件夹，放在迁移后的磁盘位置即可。
迁移完成后，点击程序启动文件，即可重新运行记账系统。
docker、NAS系统数据迁移方式
迁移记账数据文件夹
将宿主机的记账数据文件夹（账单图片文件夹、ssl证书文件、数据库、配置文件）复制到更换后的电脑、服务器上。
3-下载最新容器镜像，重新配置映射文件夹
在 https://www.88jizhang.com/private/gongneng.html 找到最新的镜像文件地址
将下面的docker run命令修改后，运行：
code
docker run -d \
--name 88jizhang \ # 容器命名为88jizhang
-p 5188:5188 \ # 宿主机5188端口(冒号左边)映射容器5188端口(冒号右边)
-p 5199:5199 \ # 宿主机5199端口(冒号左边)映射容器5199端口(冒号右边)
-v /home/zhangsan/docker/88jizhang/data:/app/data \ # 映射数据库文件
-v /home/zhangsan/docker/88jizhang/https:/app/https \ # 映射SSL证书目录
-v /home/zhangsan/docker/88jizhang/zhangdanimages :/app/zhangbenpicture/zhangdan-picture \ # 映射账单相册存储目录
-e TZ=Asia/Shanghai \ # 添加时区配置
--restart always \ # 添加自动重启策略
crpi-btxs8xhps2iaw65e.cn-hangzhou.personal.cr.aliyuncs.com/88jizhang/88jizhang:v1.0.13这里修改重点是：将/home/zhangsan/docker/88jizhang目录替换为宿主机的88jizhang目录 可以参照
然后重新启动容器。
温馨提示
如果设置了docker-compose.yml文件，升级将更加简单。直接删除原容器，重新利用原docker-compose.yml文件（只修改镜像地址版本号）拉取镜像并新建容器即可。