insecurity/raneto

Raneto Docker镜像

自动构建的Raneto镜像，基于最新debian:jessie（x64架构），支持指定版本构建与安全优化。

Docker标签与Git分支

• latest => 0.11.0 / master分支
• 0.11.0 / 0.11.0分支

镜像构建与优化

1. 单层镜像：所有RUN命令合并，减少最终镜像体积
2. 外部URL依赖：ADD/COPY使用外部URL，无需预先拉取仓库即可构建：

   bash
   docker build -t "raneto:latest" https://bitbucket.org/jtof_fap/raneto/raw/master/Dockerfile
   

3. 版本动态指定：通过ARG参数选择Raneto版本：

   bash
   docker build -t "raneto:0.11.0" --build-arg VERSION=0.11.0 https://bitbucket.org/jtof_fap/raneto/raw/master/Dockerfile
   

   版本列表见：https://github.com/gilbitron/Raneto/tags

镜像自动更新

当以下情况发生时自动重建：

• 基础镜像（insecurity/node:6.4.0）更新
• Git仓库（https://bitbucket.org/jtof_fap/raneto/%EF%BC%89%E6%9B%B4%E6%96%B0

获取镜像

bash
docker pull docker.xuanyuan.run/insecurity/raneto:latest
docker pull docker.xuanyuan.run/insecurity/raneto:0.11.0

快速运行

带Git方式

bash
git clone https://jtof_fap@bitbucket.org/jtof_fap/raneto.git && cd raneto
mkdir -p ./Data/Content/ ./Data/Conf ./Data/Theme && chown -R 1000:1000 ./Data && chmod -R 700 ./Data
cp Compose/docker-compose.yml ./
docker-compose up -d

不带Git方式

bash
mkdir Raneto && cd Raneto
mkdir -p ./Data/Content/ ./Data/Conf ./Data/Theme && chown -R 1000:1000 ./Data && chmod -R 700 ./Data
wget https://bitbucket.org/jtof_fap/raneto/raw/master/Dockerfile
wget https://bitbucket.org/jtof_fap/raneto/raw/master/Compose/docker-compose.yml
docker-compose up -d

持久化配置

使用以下卷实现持久化：

• $DATADIR/Conf:/srv/raneto/conf：配置文件目录
• $DATADIR/Content:/srv/raneto/content：Markdown文档目录
• $DATADIR/Theme:/srv/raneto/themes/custom：自定义主题目录

首次运行后，需修改$DATADIR/Conf/config.default.js中的内容目录路径：
将content_dir : __dirname + '/../example/content/'改为content_dir : __dirname + '/../content/'，然后重启容器即可使用自定义文档。

容器安全

1. 非root用户运行：容器以raneto用户（UID/GID 1000）运行，避免特权风险
2. 端口限制：默认暴露3000端口（非root用户无法绑定<1024端口）
3. 权限增强：docker-compose中禁用所有默认capabilities并启用安全选项：

   yaml
   cap_drop:
     - ALL
   security_opt:
     - no-new-privileges
   

核心功能

• 快速搭建Markdown知识库系统
• 支持自定义配置与主题
• 安全的非root用户运行模式
• 持久化存储文档与配置

使用场景

• 团队内部文档管理平台
• 个人技术知识库搭建
• 开源项目文档站点部署
• 企业内部知识共享系统