voidic/snort

snort.social Docker镜像文档

镜像概述

snort.social是一个面向去中心化社交网络的Docker镜像，旨在提供安全、隐私保护的社交媒体服务。该镜像封装了完整的社交网络平台，允许用户快速部署和运行自己的社交节点，参与去中心化社交网络生态。

核心功能和特性

• 去中心化架构，用户数据控制权归个人所有
• 支持文本、图片、视频等多种内容形式分享
• 内置加密通信功能，保障用户隐私安全
• 开放API接口，支持第三方应用集成
• 响应式设计，适配桌面和移动设备
• 社区管理工具，支持节点自定义规则
• 开源代码base，支持用户审计和自定义开发

使用场景和适用范围

• 个人用户搭建私人社交节点
• 组织或社区构建专属社交网络
• 开发者学习和研究去中心化社交技术
• 隐私敏感型用户寻找替代主流社交平台的解决方案
• 企业内部部署安全的团队协作社交平台

部署要求

• Docker Engine 20.10+
• Docker Compose 2.0+
• 至少2GB RAM (推荐4GB+)
• 20GB以上可用磁盘空间
• 稳定的网络连接

快速开始

使用docker run部署

bash
docker run -d \
  --name=snort-social \
  -p 8080:8080 \
  -v snort_data:/app/data \
  -e DOMAIN=your-domain.com \
  -e ADMIN_EMAIL=admin@example.com \
  snort.social:latest

使用docker-compose部署

创建docker-compose.yml文件:

yaml
version: '3'

services:
  snort:
    image: snort.social:latest
    container_name: snort-social
    ports:
      - "8080:8080"
    volumes:
      - snort_data:/app/data
    environment:
      - DOMAIN=your-domain.com
      - ADMIN_EMAIL=admin@example.com
      - DB_TYPE=sqlite # 可选: postgres, mysql
      - LOG_LEVEL=info
      - MAX_UPLOAD_SIZE=20M
    restart: unless-stopped
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost:8080/health"]
      interval: 30s
      timeout: 10s
      retries: 3

volumes:
  snort_data:

启动服务:

bash
docker-compose up -d

环境变量配置

持久化数据

容器使用/app/data目录存储所有用户数据、配置文件和媒体内容。建议使用Docker卷(volume)或绑定挂载(bind mount)持久化此目录:

bash
# 使用卷(推荐)
docker volume create snort_data
docker run -v snort_data:/app/data snort.social:latest

# 使用绑定挂载
docker run -v /path/on/host:/app/data snort.social:latest

网络配置

默认情况下，snort.social容器监听8080端口。建议结合反向代理(如Nginx、Traefik)使用HTTPS:

nginx
server {
    listen 443 ssl;
    server_name your-domain.com;

    ssl_certificate /path/to/cert.pem;
    ssl_certificate_key /path/to/key.pem;

    location / {
        proxy_pass http://localhost:8080;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

维护和更新

检查容器状态

bash
docker ps | grep snort-social
docker logs -f snort-social

更新镜像

bash
# 拉取最新镜像
docker pull snort.social:latest

# 停止并删除旧容器
docker stop snort-social
docker rm snort-social

# 使用新镜像启动
docker run [your-options] snort.social:latest

数据备份

bash
# 创建数据卷备份
docker run --rm -v snort_data:/source -v $(pwd):/backup alpine tar -czf /backup/snort_backup.tar.gz -C /source .

常见问题

如何修改管理员密码?

bash
docker exec -it snort-social ./bin/change-password admin newpassword

如何禁用用户注册?

修改环境变量ENABLE_REGISTRATION=false后重启容器。

如何扩展存储容量?

1. 停止容器
2. 创建新的更大容量的存储卷
3. 迁移数据至新卷
4. 使用新卷重新启动容器

支持和资源

• 官方文档: [***]
• GitHub仓库: https://github.com/snort-social/snort
• 社区论坛: [***]
• 问题反馈: https://github.com/snort-social/snort/issues

许可证信息

snort.social Docker镜像基于MIT许可证发布，详细信息请参见项目源代码仓库中的LICENSE文件。