writeas/writefreely

WriteFreely 镜像文档

概述

WriteFreely 是一个精简美观的博客平台，表面简洁易用，底层功能强大。它设计灵活，旨在帮助用户广泛分享写作内容，基于纯文本构建，并支持通过 ActivityPub 协议发布到联邦宇宙（fediverse）。该平台易于安装，且轻量高效，甚至可以在树莓派等资源有限的设备上运行。

核心功能和特性

• 精简美观：界面设计简洁，专注于写作体验
• 简单与强大并存：表面操作简单，底层提供丰富功能
• 纯文本支持：基于纯文本构建，便于内容管理和迁移
• 联邦功能：通过 ActivityPub 协议连接联邦宇宙，实现内容广泛分享
• 易于安装：部署流程简单，适合各类用户
• 轻量级：资源占用低，可在树莓派等低配置设备上运行

使用场景和适用范围

• 个人博客搭建
• 小型写作平台部署
• 需要联邦社交功能的内容创作者
• 资源有限的设备（如树莓派、低配置服务器）上的博客系统
• 偏好简洁写作环境的用户

使用方法和配置说明

基本部署（Docker Run）

使用以下命令快速启动 WriteFreely 容器：

bash
docker run -d \
  --name writefreely \
  -p 8080:8080 \
  -v writefreely_data:/data \
  writefreely/writefreely:latest

参数说明：

• -p 8080:8080：将容器内的 8080 端口映射到主机的 8080 端口，用于访问 Web 界面
• -v writefreely_data:/data：挂载数据卷，持久化存储博客数据

配置文件

WriteFreely 的配置文件位于容器内的 /data/config.ini，可通过数据卷进行修改。主要配置项包括：

• 站点名称、描述和 URL
• 数据库设置（默认使用 SQLite，也可配置 PostgreSQL）
• ActivityPub 联邦功能开关
• 用户注册设置（开放注册或邀请制）

Docker Compose 配置

创建 docker-compose.yml 文件，内容如下：

yaml
version: '3'
services:
  writefreely:
    image: writefreely/writefreely:latest
    container_name: writefreely
    ports:
      - "8080:8080"
    volumes:
      - writefreely_data:/data
    restart: unless-stopped

volumes:
  writefreely_data:

启动服务：

bash
docker-compose up -d