蚁阅（RSSAnt）安装与配置指南

蚁阅（RSSAnt）安装与配置指南

rssant 蚁阅 - 让 RSS 更好用，轻松订阅你喜欢的博客和资讯 项目地址: https://gitcode.com/gh_mirrors/rs/rssant

1. 项目基础介绍

蚁阅（RSSAnt）是一个开源项目，旨在让RSS（Really Simple Syndication）订阅更加方便和高效。它允许用户轻松订阅喜欢的博客和资讯，并提供全文阅读、播客和视频内容支持。项目使用Python作为主要的编程语言，采用Docker容器化技术进行部署。

2. 项目使用的关键技术和框架

• 编程语言：Python
• Web框架：Django
• 数据库：PostgreSQL
• 前端框架：Bootstrap（用于页面设计）
• 容器化技术：Docker
• 持续集成：Travis CI

3. 项目安装和配置的准备工作

在开始安装之前，请确保您的服务器或本地环境满足以下要求：

• 操作系统：Linux 或 macOS
• Docker：已安装并配置完成
• Python环境：Python 3.8
• 网络：确保能够访问互联网以下载依赖和项目文件

详细安装步骤

步骤 1：克隆项目仓库

首先，您需要克隆项目仓库到本地环境：

git clone https://github.com/anyant/rssant.git
cd rssant

步骤 2：准备配置文件

在项目目录中创建一个名为 rssant.env 的文件，并根据项目需求填写以下内容：

# 默认关闭DEBUG，请勿在开发测试之外开启DEBUG
RSSANT_DEBUG=0

# 请随机生成一个字符串
RSSANT_SECRET_KEY=SECRET

# 应用的访问地址
RSSANT_ROOT_URL=http://localhost:6789

# 检查订阅的时间间隔，默认30分钟
RSSANT_CHECK_FEED_MINUTES=30

# GitHub OAuth callback (如果需要)
RSSANT_GITHUB_CLIENT_ID=your_github_client_id
RSSANT_GITHUB_SECRET=your_github_secret

# SMTP邮件功能配置 (如果需要)
RSSANT_ADMIN_EMAIL=your_email@example.com
RSSANT_SMTP_ENABLE=true
RSSANT_SMTP_HOST=smtp.example.com
RSSANT_SMTP_PORT=587
RSSANT_SMTP_USE_SSL=true
RSSANT_SMTP_USERNAME=your_smtp_username
RSSANT_SMTP_PASSWORD=your_smtp_password

# RSS代理功能配置 (如果需要)
RSSANT_RSS_PROXY_ENABLE=true
RSSANT_RSS_PROXY_URL=http://proxy.example.com
RSSANT_RSS_PROXY_TOKEN=your_proxy_token

# 允许订阅局域网地址
RSSANT_ALLOW_PRIVATE_ADDRESS=true

# 数据库配置
RSSANT_PG_DB=rssant
RSSANT_PG_HOST=localhost
RSSANT_PG_USER=rssant
RSSANT_PG_PASSWORD=rssant

步骤 3：创建Docker卷

在项目目录中执行以下命令以创建Docker卷：

docker volume create rssant-postgres-data
docker volume create rssant-postgres-logs

步骤 4：启动Docker服务

创建一个名为 start.sh 的脚本文件，并填入以下内容：

#!/bin/bash
docker volume create rssant-postgres-data ||
true
docker volume create rssant-postgres-logs ||
true
docker rm -f rssant ||
true
docker run -ti --name rssant -d \
-p 6789:80 \
--env-file ~/rssant/rssant.env \
-v rssant-postgres-data:/var/lib/postgresql/11/main \
-v rssant-postgres-logs:/var/log/postgresql \
--log-driver json-file --log-opt max-size=50m --log-opt max-file=10 \
--restart unless-stopped \
guyskk/rssant:latest
docker logs --tail 1000 -f rssant

确保脚本具有执行权限：

chmod +x start.sh

然后执行脚本以启动服务：

./start.sh

步骤 5：访问和管理蚁阅

服务启动后，您可以通过浏览器访问 http://localhost:6789/admin/ 来管理蚁阅。默认的用户名和密码为 admin，请在登录后及时更改密码。

以上步骤即为蚁阅的详细安装和配置指南。祝您使用愉快！

rssant 蚁阅 - 让 RSS 更好用，轻松订阅你喜欢的博客和资讯 项目地址: https://gitcode.com/gh_mirrors/rs/rssant