# obsidian-image

**Repository Path**: weedd/obsidian-image

## Basic Information

- **Project Name**: obsidian-image
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-06
- **Last Updated**: 2026-06-06

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# obsidian-remote + Gitee 自动同步镜像

基于 [`linuxserver/obsidian`](https://github.com/linuxserver/docker-obsidian) 构建，内置 **s6 长驻服务**每小时自动同步 `/vaults` 与远程 Gitee 仓库。

## Build

```bash
docker build -t registry.cn-hangzhou.aliyuncs.com/plm/obsidian:4 .
docker push registry.cn-hangzhou.aliyuncs.com/plm/obsidian:4
```

### 目录结构

```
obsidian-image/
├── Dockerfile                          # 基于 linuxserver/obsidian:1.12.7
├── docker-compose.yml                  # 即用版本
├── README.md
├── scripts/
│   ├── entry-git-sync.sh               # cont-init：写 git 配置和凭据
│   ├── git-sync.sh                     # 主同步脚本（含凭证自检）
│   ├── git-sync.service                # s6 长驻服务
│   └── cron-runner.sh                  # 手动触发入口 → /usr/local/bin/git-sync-now
├── config/                             # obsidian 配置（bind mount）
├── data/                               # vault（bind mount）
└── logs/                               # 同步日志
    ├── sync.log
    └── ALERT.log
```

## 使用

```bash
# 首次部署
docker compose up -d

# 更新镜像
docker compose pull
docker compose down
rm -rf ./data/*
docker compose up -d
```

浏览器访问 `http://IP:13000`，用户 `admin`，密码 `123`。（HTTPS 用 `13001`）

## 镜像特点

- **KasmVNC**（端口 3000/3001），非 xrdp
- **中文字体已内置**（fonts-noto-cjk），启动不再 apt 下载
- **git 2.47**，凭证在 git-sync.sh 每次运行时自动写入，不依赖 cont-init
- **HOME 强制 /root**，避免容器默认 HOME=/config 导致的 git 路径问题
- 同步策略：`add→commit→fetch→merge -X ours（本地优先）→push`

## 手动控制 git 同步

```bash
# 手动触发一次
docker exec obsidian git-sync-now

# 查看日志
cat ./logs/sync.log
cat ./logs/ALERT.log        # 正常为空，有内容表示冲突

# 进容器手工处理冲突
docker exec -it obsidian bash
cd /vaults
git status
git-sync-now
```

## 环境变量

| 变量 | 说明 | 默认值 |
| --- | --- | --- |
| `GIT_SYNC_DIR` | vault 路径 | `/vaults` |
| `GIT_REPO_URL` | Gitee 仓库 HTTPS 地址 | 必填 |
| `GIT_BRANCH` | 远程分支 | `master` |
| `GIT_USERNAME` | Gitee 用户名 | 必填 |
| `GIT_PASSWORD` | Gitee 密码/令牌 | 必填 |
| `GIT_USER_NAME` | commit 作者名 | `zcc` |
| `GIT_USER_EMAIL` | commit 作者邮箱 | 必填 |
| `GIT_SYNC_INTERVAL` | 同步间隔（秒） | `3600` |
| `PUID` | 运行用户 UID | `1000` |
| `PGID` | 运行用户 GID | `1000` |
| `TZ` | 时区 | `Asia/Shanghai` |
| `LC_ALL` | 语言 | `zh_CN.UTF-8` |
| `CUSTOM_USER` | 网页登录用户 | `admin` |
| `PASSWORD` | 网页登录密码 | `123` |
| `TITLE` | 页面标题 | `obsidian-web` |

## 注意

- **首次启动 /data 非空但不含 .git**：脚本会自动 `git init` + commit 现有文件并推送
- **清空 data 再启动**会重新 clone（已 push 过的远程仓库不会丢数据）
- 不要用 DOCKER_MODS/INSTALL_PACKAGES，字体已烧入镜像