blog

这是一个简单的自托管、轻量级单用户PHP博客，可创建类似***的个人动态流。支持向他人开放阅读权限，分享包含图片、代码高亮或链接的富文本内容。

轻量级体现在：

• 无npm依赖，不会产生占用1GB空间的冗余node_modules目录
• 无构建流程，所见即所得的纯代码，无需额外安装步骤
• 无性能开销，仅保留核心功能，使用简单

在线演示

在线演示地址：
[***]

注意：演示环境资源有限，有严格的速率限制且可能随时重置。文件上传功能可能无法正常工作，但足以展示产品基本功能。

截图

零配置部署

容器默认使用SQLite作为数据库，无需初始配置即可运行。如需更好性能，建议使用MySQL。

基础运行命令

docker run -d -p 80:80 -v $PWD/data:/var/www/html/data m1k1o/blog:latest

使用环境变量配置

支持设置以BLOG_为前缀的大写环境变量（对应config.ini中的配置项）：

docker run -d \
  -p 80:80 \
  -e "TZ=Europe/Vienna" \
  -e "BLOG_TITLE=博客" \
  -e "BLOG_NAME=Max Musermann" \
  -e "BLOG_NICK=用户名" \
  -e "BLOG_PASS=密码" \
  -e "BLOG_LANG=en" \
  -v $PWD/data:/var/www/html/data \
  m1k1o/blog:latest

docker-compose配置

version: "3"
services:
  blog:
    image: m1k1o/blog:latest
    restart: unless-stopped
    environment:
        TZ: Europe/Vienna
        BLOG_TITLE: 博客
        BLOG_NAME: Max Musermann
        BLOG_NICK: 用户名
        BLOG_PASS: 密码
        BLOG_LANG: en
    ports:
      - 80:80
    volumes:
      - ./data:/var/www/html/data

使用docker-compose配合MySQL安装独立应用

需先安装docker-compose。

步骤1：下载并运行docker-compose.yml

wget [***]
docker-compose up -d

可通过环境变量自定义配置（未指定则使用默认值）：

• HTTP_PORT=80 - 博客访问端口
• DATA=./data - 用户数据存储目录

环境变量可存储在.env文件或直接通过命令传递：

HTTP_PORT=3001 DATA=/home/user/blog docker-compose up -d

步骤2：创建data/目录并下载config.ini文件

创建数据目录并下载默认配置文件：

mkdir data && cd data
wget [***]

可直接修改此config.ini文件，或通过以BLOG_为前缀的大写环境变量配置（如BLOG_NAME: Max的博客）。

正确的权限设置

确保./data/目录有正确权限，Apache以www-data用户运行，需对该目录有写入权限（用于图片上传）。

推荐方案

将目录所有者改为www-data用户：

chown 33:33 ./data/

或将www-data用户添加到目录所属用户组。

不推荐方案（但可临时使用）

设置777权限（不建议，存在安全风险）：

chmod 777 ./data/

注意：777权限会向所有用户开放读写执行权限，可能被攻击者利用，应避免使用。

手动安装

若不使用Docker，可手动安装。

系统要求

• Apache 2.0+
• PHP 7.4
• MariaDB 10.1 或 SQLite 3

注意：若使用Nginx等其他Web服务器，需确保敏感文件不被公开访问。Apache通过.htaccess保护这些文件，其他环境需手动配置：

• config.ini - 禁止公开访问所有.ini文件
• data/logs/_ANY_.log - 确保日志文件中无敏感信息

数据库架构

数据库架构文件位于./app/db目录。

调试模式

在配置文件中添加debug = true可启用调试模式，显示服务器配置详情及缺失的PHP扩展错误。

配置文件

请勿编辑./config.ini文件。如需修改配置，复制该文件到./data/config.ini后编辑。

原因：配置文件更新时（如新增功能），直接修改原文件可能导致版本冲突；且可能意外将敏感信息提交到Git。/data目录已被Git忽略，确保个人数据和图片不会被提交。

功能特性

• 支持深色模式、视网膜屏幕适配，提供传统主题（兼容旧浏览器）
• 文本中可使用BBcode标记
• 帖子访问权限控制：所有人、仅自己或仅好友
• 帖子额外字段：心情、与谁和在哪里
• 可隐藏帖子（仅在需要时显示）
• 粘贴链接自动生成预览（含标题、描述和图片，可配置代理）
• 多方式图片上传：
  • 按钮上传（移动端友好）
  • 拖放上传（拖入文本框）
  • 粘贴上传（Ctrl+V粘贴到文本框）
• 使用[code]..代码..[/code]标记高亮代码
• 使用[goal]目标文本[/goal]标记突出目标内容
• 支持帖子标签（允许字符A-Za-z0-9-_，以空格或行尾结束）：#歌曲
• 通过URL参数筛选帖子：
  • 按标签：[***]
  • 按位置：[***]
  • 按日期范围：[***]（支持YYYY-MM-DD或YYYY-MM格式）
  • 参数可组合：[***]

访问控制

博客采用强制访问控制（MAC），支持3种访问级别：

• 私有：仅配置文件中指定的nick用户可见（需密码登录）
• 好友：仅指定好友列表中的用户可见（需好友账号密码登录）
• 公开：无需登录即可查看

可通过docker-compose.yml配置管理员和好友：

version: "3"
services:
  blog:
    image: m1k1o/blog:latest
    restart: unless-stopped
    environment:
        TZ: Europe/Vienna
        BLOG_NICK: 管理员用户名
        BLOG_PASS: 管理员密码
        BLOG_FRIENDS: |
          好友1:密码1
          好友2:密码2
    ports:
      - 80:80
    volumes:
      - ./data:/var/www/html/data

或在config.ini中配置：

[admin]
force_login = true
nick = 管理员用户名
pass = 管理员密码

[friends] 
friends[好友1] = 密码1
friends[好友2] = 密码2

本地化

时区设置

可在配置文件中设置时区，Docker用户可通过TZ环境变量指定（时区列表见这里）。

语言支持

支持多语言，可通过URL参数切换：[***]。

• en - 🇬🇧 英语
• de - 🇩🇪 德语
• sk - 🇸🇰 斯洛伐克语
• fr - 🇫🇷 法语（感谢 @Phundrak）
• cz - 🇨🇿 捷克语（感谢 @djfinch）
• bs - 🇧🇦 波斯尼亚语（感谢 @hajro92）
• es - 🇪🇸 西班牙语（感谢 @ManuLinares）