docs: rename MY_REQUIREMENTS.md → FORK.md, drop stale DEPLOY.md
- 重命名为 FORK.md,对接更通用的 fork-doc 命名约定 - DEPLOY.md 内容全过期(ghcr.io 镜像、myrequirement 分支、 docker run 风格部署),全部已废 — 部署文档现在两层: nas-infra/README.md(compose level)+ CLAUDE.md(CI 排查) - README.md 顶部加一行 fork notice,链到 FORK.md 与 CLAUDE.md (单行变更,rebase 友好) - FORK.md 顶部加关联文档表 Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
@@ -1,115 +0,0 @@
|
||||
# 部署说明
|
||||
|
||||
## 镜像地址
|
||||
|
||||
```
|
||||
ghcr.io/zhengchentao/ezbookkeeping:latest
|
||||
```
|
||||
|
||||
每次向 `myrequirement` 分支推送代码,GitHub Actions 自动构建并推送新镜像。
|
||||
|
||||
---
|
||||
|
||||
## 首次迁移(从官方镜像换成自定义镜像)
|
||||
|
||||
### 1. 备份容器内配置文件到宿主机
|
||||
|
||||
```bash
|
||||
sudo docker cp ezbookkeeping:/ezbookkeeping/conf/ezbookkeeping.ini /opt/ezbookkeeping/ezbookkeeping.ini
|
||||
```
|
||||
|
||||
> 这样之后删容器也不会丢配置。
|
||||
|
||||
### 2. 停止并删除旧容器
|
||||
|
||||
```bash
|
||||
docker stop ezbookkeeping && docker rm ezbookkeeping
|
||||
```
|
||||
|
||||
> 只删容器本身,数据目录不受影响。
|
||||
|
||||
### 3. 登录 GitHub Container Registry(只需一次)
|
||||
|
||||
在 GitHub → Settings → Developer settings → Personal access tokens → Tokens (classic) 生成 token,勾选 `read:packages`,然后:
|
||||
|
||||
```bash
|
||||
echo 你的TOKEN | docker login ghcr.io -u zhengchentao --password-stdin
|
||||
```
|
||||
|
||||
### 4. 拉取新镜像
|
||||
|
||||
```bash
|
||||
docker pull ghcr.io/zhengchentao/ezbookkeeping:latest
|
||||
```
|
||||
|
||||
### 5. 启动容器
|
||||
|
||||
```bash
|
||||
docker run -d \
|
||||
--name ezbookkeeping \
|
||||
--restart unless-stopped \
|
||||
-p 8080:8080 \
|
||||
-v /opt/ezbookkeeping/data:/ezbookkeeping/data \
|
||||
-v /opt/ezbookkeeping/ezbookkeeping.ini:/ezbookkeeping/conf/ezbookkeeping.ini \
|
||||
-e EBK_MCP_ENABLE_MCP=true \
|
||||
-e EBK_SECURITY_ENABLE_API_TOKEN=true \
|
||||
ghcr.io/zhengchentao/ezbookkeeping:latest
|
||||
```
|
||||
|
||||
**参数说明:**
|
||||
| 参数 | 含义 |
|
||||
|------|------|
|
||||
| `-d` | 后台运行 |
|
||||
| `--restart unless-stopped` | 服务器重启后自动启动 |
|
||||
| `-p 8080:8080` | 端口映射 |
|
||||
| `-v .../data:...` | 挂载数据目录(数据库、图片等) |
|
||||
| `-v .../ezbookkeeping.ini:...` | 挂载配置文件 |
|
||||
| `-e EBK_*` | 环境变量覆盖配置 |
|
||||
|
||||
### 6. 确认运行正常
|
||||
|
||||
```bash
|
||||
docker ps # 确认容器在运行
|
||||
docker logs ezbookkeeping # 查看启动日志,确认无报错
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 后续更新(代码有改动时)
|
||||
|
||||
```bash
|
||||
# 拉取最新镜像
|
||||
docker pull ghcr.io/zhengchentao/ezbookkeeping:latest
|
||||
|
||||
# 停止并删除旧容器
|
||||
docker stop ezbookkeeping && docker rm ezbookkeeping
|
||||
|
||||
# 重新启动(与首次启动命令相同)
|
||||
docker run -d \
|
||||
--name ezbookkeeping \
|
||||
--restart unless-stopped \
|
||||
-p 8080:8080 \
|
||||
-v /opt/ezbookkeeping/data:/ezbookkeeping/data \
|
||||
-v /opt/ezbookkeeping/ezbookkeeping.ini:/ezbookkeeping/conf/ezbookkeeping.ini \
|
||||
-e EBK_MCP_ENABLE_MCP=true \
|
||||
-e EBK_SECURITY_ENABLE_API_TOKEN=true \
|
||||
ghcr.io/zhengchentao/ezbookkeeping:latest
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 常用运维命令
|
||||
|
||||
```bash
|
||||
# 查看运行中的容器
|
||||
docker ps
|
||||
|
||||
# 查看容器实时日志(Ctrl+C 退出)
|
||||
docker logs -f ezbookkeeping
|
||||
|
||||
# 进入容器内部排查问题
|
||||
docker exec -it ezbookkeeping sh
|
||||
|
||||
# 查看磁盘占用
|
||||
docker system df
|
||||
```
|
||||
@@ -1,6 +1,11 @@
|
||||
# ezBookkeeping 个人需求清单
|
||||
# ezBookkeeping 个人 fork 改动清单
|
||||
|
||||
> 基于 fork 版本的定制开发需求,持续更新。
|
||||
> 本文件记录这个 fork 相对上游 [mayswind/ezbookkeeping](https://github.com/mayswind/ezbookkeeping) 的所有定制改动 + 进度状态。
|
||||
|
||||
> 关联文档:
|
||||
> - [`CLAUDE.md`](CLAUDE.md) —— 仓库分支模型 / 上游同步流程 / CI 排查路径(meta 层)
|
||||
> - 部署:见自家 NAS infra repo `git.zhengchentao.win/dev/nas-infra` 的 README(compose-level)
|
||||
>
|
||||
> 标注:❌ 难/暂缓 | ❓ 待定 | 🔍 调查中 | 🟢 已完成
|
||||
|
||||
---
|
||||
@@ -1,4 +1,9 @@
|
||||
# ezBookkeeping
|
||||
|
||||
> **Personal fork notice**: This is a personal fork of [mayswind/ezbookkeeping](https://github.com/mayswind/ezbookkeeping). For the list of custom changes see [`FORK.md`](FORK.md); for branch model / upstream-sync flow / CI troubleshooting see [`CLAUDE.md`](CLAUDE.md). Upstream README content follows below.
|
||||
|
||||
---
|
||||
|
||||
[](https://github.com/mayswind/ezbookkeeping/blob/master/LICENSE)
|
||||
[](https://goreportcard.com/report/github.com/mayswind/ezbookkeeping)
|
||||
[](https://github.com/mayswind/ezbookkeeping/releases)
|
||||
|
||||
Reference in New Issue
Block a user