ldonleycb/hackers-organized

镜像概述

该Docker镜像包含一个Hacker News克隆应用，旨在模拟原Hacker News平台的核心功能和用户界面。应用提供新闻聚合、用户投票、评论互动等功能，适合作为Web开发学习案例、技术演示或二次开发的基础。

核心功能与特性

• 新闻聚合展示：支持用户提交和浏览技术、科技类新闻链接及内容摘要，按热度或时间排序
• 用户投票系统：实现新闻条目点赞/点踩功能，投票结果影响内容展示优先级
• 评论互动：支持用户对新闻条目进行多层级评论及回复，形成讨论线程
• 用户认证：包含基础的用户注册、登录及权限管理功能，支持用户身份验证
• 响应式界面：适配桌面端和移动端设备的浏览体验，兼容主流浏览器
• 轻量化架构：基于现代Web技术栈构建，部署依赖简单，资源占用低

使用场景与适用范围

• Web开发学习：适合学习前后端数据交互、用户认证流程、实时投票系统等Web开发核心概念
• 技术演示：作为新闻类Web应用的功能演示原型，展示内容聚合与用户互动功能
• 教学案例：用于讲解Docker容器化部署、Web应用架构设计、数据库交互等技术点
• 二次开发：可基于该镜像快速扩展功能（如添加内容审核、多语言支持等），开发定制化新闻类应用

使用方法与配置说明

基本使用

通过以下命令快速启动应用（默认配置）：

bash
docker run -d -p 8080:80 --name hackernews-clone [镜像名称]:[标签]

启动后，访问 http://localhost:8080 即可打开应用界面。

环境变量配置

应用支持通过环境变量自定义运行参数，常用配置项如下：

• PORT：应用监听端口（容器内），默认值为 80
• DB_CONNECTION：数据库连接字符串（支持SQLite/MySQL/PostgreSQL），默认使用内置SQLite（路径：/app/data/db.sqlite）
• ADMIN_USER：默认管理员用户名，默认值为 admin
• ADMIN_PASSWORD：默认管理员密码，默认值为 admin123
• ALLOW_REGISTRATION：是否允许普通用户注册，取值 true/false，默认 true
• SESSION_SECRET：用户会话加密密钥，建议生产环境自定义，默认自动生成

示例（自定义端口与管理员账户）：

bash
docker run -d \
  -p 3000:3000 \
  -e PORT=3000 \
  -e ADMIN_USER=superuser \
  -e ADMIN_PASSWORD=SecurePass123! \
  -e ALLOW_REGISTRATION=false \
  --name hackernews-clone [镜像名称]:[标签]

Docker Compose 配置示例

以下为包含数据持久化的 docker-compose.yml 示例：

yaml
version: '3.8'
services:
  hackernews-app:
    image: docker.xuanyuan.run/[镜像名称]:[标签]
    ports:
      - "8080:80"  # 宿主机端口:容器内端口（需与PORT环境变量一致）
    environment:
      - DB_CONNECTION=sqlite:///data/db.sqlite
      - SESSION_SECRET=your_custom_secret_key_here
      - ADMIN_USER=demo_admin
      - ADMIN_PASSWORD=Demo@Pass123
    volumes:
      - ./app-data:/app/data  # 持久化存储数据库文件及用户上传内容
    restart: unless-stopped

通过 docker-compose up -d 启动服务，数据将保存在宿主机 ./app-data 目录中。

数据持久化说明

应用数据（用户信息、新闻条目、评论、投票记录等）默认存储在容器内 /app/data 目录。为避免容器重启后数据丢失，建议通过 Docker 卷或宿主机目录挂载持久化该路径（如上述 docker-compose 示例）。