kingwrcy/moments

moments 极简朋友圈应用镜像文档

概述

moments是一个基于Docker的极简朋友圈应用镜像，旨在提供轻量级、零复杂配置的社交解决方案。该应用以"极简"为核心设计理念，专注于基础社交功能的实现，无需繁琐部署流程即可快速搭建个人或小型社区的朋友圈平台，满足轻量级社交互动需求。

核心功能和特性

• 动态发布：支持文字、图片类型动态发布，支持基本格式排版
• 时间线查看：按时间顺序展示个人及关注对象的动态内容
• 社交互动：提供点赞、评论功能，支持基本互动操作
• 用户管理：包含用户注册、登录及个人信息维护功能
• 简洁界面：无冗余设计，专注内容展示，响应式布局适配多设备
• 轻量级架构：应用资源占用低，支持在低配置环境稳定运行
• Docker化部署：一键启动，无需复杂环境依赖配置

使用场景和适用范围

• 个人用户：搭建私人朋友圈，记录生活或工作动态
• 小型团队/社区：构建内部交流平台，促进成员间信息共享
• 网站集成：作为轻量级社交模块嵌入现有网站，增强用户互动
• 教学/演示：作为Docker应用部署示例或Web开发教学中的社交功能案例

使用方法和配置说明

前提条件

• 已安装Docker Engine（20.10+版本）
• （可选）Docker Compose（用于多容器部署场景）

获取镜像

通过Docker Hub拉取最新版本镜像：

bash
docker pull moments-app/moments:latest

基本使用（单容器部署）

使用以下命令快速启动应用：

bash
docker run -d \
  --name moments \
  -p 8080:80 \
  -v ./moments-data:/app/data \
  -e "ADMIN_USER=admin" \
  -e "ADMIN_PASSWORD=yourpassword" \
  moments-app/moments:latest

参数说明：

• -p 8080:80：将容器内80端口映射到主机8080端口
• -v ./moments-data:/app/data：挂载主机目录用于数据持久化（动态、用户信息等）
• -e "ADMIN_USER=admin"：设置管理员用户名（默认：admin）
• -e "ADMIN_PASSWORD=yourpassword"：设置管理员密码（首次启动必须设置）

Docker Compose部署

创建docker-compose.yml文件：

yaml
version: '3'
services:
  moments:
    image: moments-app/moments:latest
    container_name: moments
    ports:
      - "8080:80"
    volumes:
      - ./moments-data:/app/data
    environment:
      - ADMIN_USER=admin
      - ADMIN_PASSWORD=yourpassword
      - PORT=80
      - DATA_PATH=/app/data
    restart: unless-stopped

启动服务：

bash
docker-compose up -d

环境变量配置

数据持久化

应用所有用户数据（动态、用户信息、配置等）存储在容器内/app/data目录，通过挂载主机目录实现持久化：

bash
-v /本地路径/moments-data:/app/data

注意：挂载目录需确保有读写权限，避免数据丢失

访问应用

部署完成后，通过浏览器访问：http://主机IP:映射端口（如http://localhost:8080），使用管理员账号登录后即可开始使用。

注意事项

• 首次登录后建议立即修改管理员密码
• 生产环境使用时，建议配合反向代理（如Nginx）配置HTTPS
• 高并发场景下，可通过调整Docker资源限制（--memory、--cpus）优化性能
• 如需迁移数据，直接复制挂载的moments-data目录到新环境即可