Sign inSign up

sayunchuan/powerwiki

By sayunchuan

•Updated 6 months ago

Image
0

2.5K

sayunchuan/powerwiki repository overview

⁠PowerWiki Docker Image

⁠Credits / 致谢

This Docker image is based on PowerWiki⁠ by steven-ld⁠.

本 Docker 镜像基于 steven-ld⁠ 开发的 PowerWiki⁠ 项目构建。


⁠English

A modern Git-based Markdown wiki system with auto-sync, syntax highlighting, and Feishu-style UI.

⁠Supported Tags
TagDescription
latestLatest build, always up-to-date
1.2.0Synced with upstream tag v1.2.0
1.2.0-5Based on v1.2.0 + 5 additional commits
20260204Build date (YYYYMMDD)
20260204-abc1234Build date + commit SHA

Version Format: {upstream_version} or {upstream_version}-{commits}

  • 1.2.0 — Exactly synced with upstream release v1.2.0
  • 1.2.0-5 — Based on v1.2.0, with 5 commits after merging the tag (bug fixes, Docker improvements, etc.)

Recommended:

  • Production: Use specific version like 1.2.0 or 1.2.0-5
  • Development: Use latest for newest features
⁠Quick Start
docker run -d -p 3150:3150 sayunchuan/powerwiki

Visit http://localhost:3150⁠

⁠Configuration

Mount config.json:

docker run -d -p 3150:3150 \
  -v /path/to/config.json:/app/config.json \
  sayunchuan/powerwiki

Persist statistics data:

docker run -d -p 3150:3150 \
  -v /path/to/config.json:/app/config.json \
  -v /path/to/data:/app/data \
  sayunchuan/powerwiki
⁠Docker Compose
version: '3.8'
services:
  powerwiki:
    image: sayunchuan/powerwiki:latest
    ports:
      - "3150:3150"
    environment:
      - NODE_ENV=production
      - DATA_DIR=/app/data
      - GIT_CACHE_DIR=/app/cache
      - LANG=zh-CN
    volumes:
      - ./config.json:/app/config.json
      - powerwiki-data:/app/data
      - powerwiki-cache:/app/cache
    restart: unless-stopped

volumes:
  powerwiki-data:
  powerwiki-cache:
⁠Configuration File

Create config.json:

{
  "gitRepo": "https://github.com/your-username/your-wiki-repo.git",
  "repoBranch": "main",
  "port": 3150,
  "siteTitle": "My Wiki",
  "siteDescription": "Knowledge Base"
}
⁠Container Info
  • Port: 3150
  • User: root
  • Data directory: /app/data
  • Git cache directory: /app/cache
⁠Environment Variables
VariableDefaultDescription
CONFIG_PATH/app/config.jsonPath to configuration file
DATA_DIR/app/dataDirectory for stats and logs
GIT_CACHE_DIR/app/cacheGit repository cache directory
LANGzh-CNConsole output language (zh-CN, en)
⁠Important Notes
  • config.json must exist before starting the container
  • Use environment variables to customize data paths

⁠中文

一个现代化的基于 Git 的 Markdown 知识库系统,支持自动同步、语法高亮和飞书风格界面。

⁠镜像标签
标签说明
latest最新构建,始终保持最新
1.2.0与上游 v1.2.0 版本同步
1.2.0-5基于 v1.2.0 + 5 个额外提交
20260204构建日期(YYYYMMDD)
20260204-abc1234构建日期 + 提交哈希

版本格式: {上游版本} 或 {上游版本}-{提交数}

  • 1.2.0 — 与上游 v1.2.0 发布版本完全同步
  • 1.2.0-5 — 基于 v1.2.0,合并该 tag 后又有 5 次提交(Bug 修复、Docker 优化等)

推荐使用:

  • 生产环境:使用指定版本如 1.2.0 或 1.2.0-5
  • 开发测试:使用 latest 获取最新功能
⁠快速开始
docker run -d -p 3150:3150 sayunchuan/powerwiki

访问 http://localhost:3150⁠

⁠配置方式

挂载配置文件:

docker run -d -p 3150:3150 \
  -v /路径/config.json:/app/config.json \
  sayunchuan/powerwiki

持久化统计数据:

docker run -d -p 3150:3150 \
  -v /路径/config.json:/app/config.json \
  -v /路径/data:/app/data \
  sayunchuan/powerwiki
⁠Docker Compose 示例
version: '3.8'
services:
  powerwiki:
    image: sayunchuan/powerwiki:latest
    ports:
      - "3150:3150"
    environment:
      - NODE_ENV=production
      - DATA_DIR=/app/data
      - GIT_CACHE_DIR=/app/cache
      - LANG=zh-CN
    volumes:
      - ./config.json:/app/config.json
      - powerwiki-data:/app/data
      - powerwiki-cache:/app/cache
    restart: unless-stopped

volumes:
  powerwiki-data:
  powerwiki-cache:
⁠配置文件说明

创建 config.json:

{
  "gitRepo": "https://github.com/用户名/仓库.git",
  "repoBranch": "main",
  "port": 3150,
  "siteTitle": "我的知识库",
  "siteDescription": "知识库描述"
}
⁠容器信息
  • 端口:3150
  • 运行用户:root
  • 数据目录:/app/data
  • Git 缓存目录:/app/cache
⁠环境变量
变量默认值说明
CONFIG_PATH/app/config.json配置文件路径
DATA_DIR/app/data统计数据和日志存储目录
GIT_CACHE_DIR/app/cacheGit 仓库缓存目录
LANGzh-CN控制台输出语言(zh-CN、en)
⁠重要说明
  • config.json 必须在启动容器前存在
  • 可通过环境变量自定义数据存储路径

Tag summary

Content type

Image

Digest

sha256:8c7076936…

Size

112.3 MB

Last updated

6 months ago

docker pull sayunchuan/powerwiki