Skip to content

Latest commit

 

History

History
322 lines (240 loc) · 9.97 KB

deploy.md

File metadata and controls

322 lines (240 loc) · 9.97 KB

🚀 部署

部署 RSS Impact 需要基本的计算机编程常识，如果您在部署过程中遇到无法解决的问题请到 issues 寻找类似的问题或 向我们提问，我们会尽快给您答复

部署涉及到以下基本编程常识：

  1. 命令行操作
  2. Git
  3. Node.js
  4. npm 或 yarn 或 pnpm

部署到可外网访问则可能涉及到：

  1. Nginx
  2. Docker 或 docker-compose
  3. Redis

Docker 镜像

支持两种注册表：

支持以下架构：

  • linux/amd64
  • linux/arm/v7
  • linux/arm64

linux/arm/v7 和 linux/arm64 尚未进行测试

有以下几种 tags：

Tag 描述 举例
latest 最新 latest
{YYYY-MM-DD} 特定日期 2024-06-07
{sha-hash} 特定提交 sha-0891338
{version} 特定版本 1.2.3

Docker Compose 部署（推荐）

下载 docker-compose.yml

wget https://raw.githubusercontent.com/CaoMeiYouRen/rss-impact-server/master/docker-compose.yml

检查有无需要修改的配置

vim docker-compose.yml  # 也可以是你喜欢的编辑器

在公网部署时请务必修改 ADMIN_PASSWORD、SESSION_SECRET 环境变量

如果要使用自定义查询功能，请修改 BASE_URL 环境变量

启动

docker-compose up -d

在浏览器中打开 http://{Server IP}:3000 即可查看结果

关闭

docker-compose down

Docker 部署

运行下面的命令下载 RSS Impact 镜像

docker pull caomeiyouren/rss-impact-server

然后运行 RSS Impact 即可

docker run -d --name rss-impact-server -p 3000:3000 caomeiyouren/rss-impact-server

在浏览器中打开 http://{Server IP}:3000 即可查看结果

您可以使用下面的命令来关闭 RSS Impact

docker stop rss-impact-server

手动部署

部署 RSS Impact 最直接的方式，您可以按照以下步骤将 RSS Impact 部署在您的电脑、服务器或者其他任何地方

# 构建后端部分
git clone https://github.com/CaoMeiYouRen/rss-impact-server.git  --depth=1
cd rss-impact-server
pnpm i --frozen-lockfile
pnpm build
# 构建前端部分
cd ../
git clone https://github.com/CaoMeiYouRen/rss-impact-web.git --depth=1
cd rss-impact-web
pnpm i --frozen-lockfile
pnpm build
# 复制前端部分到后端
cd ../
cp -rp "rss-impact-web/dist" "rss-impact-server/public"
# 启动项目
cd rss-impact-server
pnpm start

在浏览器中打开 http://{Server IP}:3000 即可查看结果

⚙ 配置

更多参数请参考 .env 文件中的说明

PORT=3000
BASE_URL='http://localhost:3000'
# 启用跨域。如果前端和后端部署在不同域名下，需要跨域时，配置该项。
# ENABLE_ORIGIN_LIST=https://example1.com,https://example2.com
# 通过 docker 部署时，也会产生跨域问题，需要配置该项。
# ENABLE_ORIGIN_LIST='http://localhost:3000,http://127.0.0.1:3000'
# 如果你有前置的反向代理服务，例如 Nginx 等，则无需配置该项。
ENABLE_ORIGIN_LIST=''
# 超时时间(ms)
TIMEOUT=30000
# 数据库类型。参考 typeorm 支持的数据库类型
DATABASE_TYPE='sqlite'
# 如果是 sqlite，则无需其他数据库相关配置
# 如果是 mysql/postgres，则需要配置 MySQL/Postgres 相关配置
# MySQL/Postgres 相关配置如下
# 数据库 host
DATABASE_HOST='localhost'
# 数据库端口。mysql 默认的端口是3306，postgres 默认端口是 5432。
DATABASE_PORT=3306
# 数据库用户名
DATABASE_USERNAME='root'
# 数据库密码
DATABASE_PASSWORD=''
# 数据库名
DATABASE_DATABASE='rss-impact'
# 连接的字符集 utf8_unicode_ci/utf8_general_ci
DATABASE_CHARSET='utf8_general_ci'
# MySQL 服务器上配置的时区 （默认：local）
DATABASE_TIMEZONE='local'
# Postgre Schema 名称，默认是 "public".
DATABASE_SCHEMA='public'

# 每页最大查询条数
PAGE_LIMIT_MAX=1000

# session 超时时间
SESSION_MAX_AGE='30d'

# 时区，默认东八区
TZ='Asia/Shanghai'

# Session Secret，自行部署时必须修改
SESSION_SECRET='RSS_IMPACT'

# admin 用户密码，自行部署时必须修改
ADMIN_PASSWORD='123456'
ADMIN_EMAIL='[email protected]'

# 数据的保存路径
DATA_PATH='./data'
# 图片等资源的保存路径
RESOURCE_DOWNLOAD_PATH='./data/download'
# 对 download 路径启用 http 静态代理，download 文件夹下的资源也可以通过 http 协议访问
ENABLE_DOWNLOAD_HTTP=true

# 最大全局 Hook 并发数
HOOK_LIMIT_MAX=10

# 同时进行检测更新的最大 RSS 数量
RSS_LIMIT_MAX=5

# 最大下载并发数
DOWNLOAD_LIMIT_MAX=5

# 最大 AI 请求并发数
AI_LIMIT_MAX=3

# 最大 BitTorrent 并发数
BIT_TORRENT_LIMIT_MAX=5

# 最大 推送 并发数
NOTIFICATION_LIMIT_MAX=5

# 启用注册
ENABLE_REGISTER=false

# Redis 连接地址
# 如果设置了 该项，则 limiter 和 session 都会用 redis
# REDIS_URL=redis://localhost:6379/

# 文章 最大保存天数
ARTICLE_SAVE_DAYS=90
# 资源 最大保存天数
RESOURCE_SAVE_DAYS=30
# Webhook和通知日志 最大保存天数
LOG_SAVE_DAYS=30

# 反转触发频率限制。单个 feed 每小时最多可反转触发的次数
REVERSE_TRIGGER_LIMIT=4

# RSS 路由缓存时间，单位：秒
CACHE_EXPIRE=300
# RSS 内存缓存时间，单位：秒
CACHE_CONTENT_EXPIRE=3600

# Sentry dsn 路径，用于错误上报
SENTRY_DSN=''

缓存配置

REDIS_URL=redis://localhost:6379/

如果设置了 该项，则 limiter 和 session 都会用 redis。

🗄️ 数据库配置

注意：SQLite 数据库是优先支持的数据库（因为开发环境使用的是SQLite）。

MySQL 和 PostgreSQL 数据库不会优先支持，可能存在兼容性问题。如果遇到此类问题，请提 issue。

如果你需要寻找一个免费的 MySQL/PostgreSQL 数据库，请参考 ripienaar/free-for-dev 中列出的云服务商，其中包含了一些免费 MySQL/PostgreSQL 数据库服务。

使用 SQLite 数据库

无需特别配置

数据库文件默认保存在 data/database.sqlite 路径下。

如果你修改了 DATA_PATH，则数据库文件在 DATA_PATH + "/database.sqlite" 路径下。

使用 MySQL 数据库

如果你需要一个免费的 MySQL 数据库，可以考虑使用 TiDB 或 Aiven for MySQL。

TiDB 提供一个 5 GB 的兼容 MySQL 的分布式数据库。详见 Pricing Details。备注：TiDB 不是完全兼容 MySQL 的，请先确保可以正常连接。

Aiven 提供一个 5 GB 的免费 MySQL 数据库。详见 Free plans。备注：在使用 aiven 之前，请先确保可以服务器可以访问 aivencloud.com，以免无法连接。

在环境变量中进行如下配置

# 指定数据库类型为 MySQL
DATABASE_TYPE='mysql'
# 数据库 host
DATABASE_HOST='localhost'
# 数据库端口。mysql 默认的端口是3306
DATABASE_PORT=3306
# 数据库用户名
DATABASE_USERNAME='root'
# 数据库密码
DATABASE_PASSWORD=''
# 数据库名
DATABASE_DATABASE='rss-impact'
# 连接的字符集 默认为 utf8_general_ci
DATABASE_CHARSET='utf8_general_ci'
# MySQL 设置索引最大长度。
# MySQL 索引最大不超过 3072 字节，在 utf8 编码下不超过 1024 字符，utf8mb4 编码不超过 768 字符
DATABASE_INDEX_LENGTH=1024
# MySQL 服务器上配置的时区 （默认：local）
DATABASE_TIMEZONE='local'
# 带有 ssl 参数的对象
DATABASE_SSL=false

注意：首次连接时会创建数据表。在 data/database.lock.json 文件存在时不会同步数据表结构。

如果希望更新数据表结构，请删除 data/database.lock.json 文件。

特别提醒：更新数据表结构可能会导致数据丢失，请提前做好备份！

使用 PostgreSQL 数据库

如果你需要一个免费的 PostgreSQL 数据库，推荐使用 Supabase 或 Vercel。

Supabase 提供一个 500 MB 的免费 PostgreSQL 数据库，并且对数据库运行时间没有限制，非常适合个人用户使用。详见 pricing

Vercel 提供一个 256 MB 的免费 PostgreSQL 数据库，但对数据库运行时间有限制。详见 Vercel Postgres Pricing

在环境变量中进行如下配置

# 指定数据库类型为 Postgres
DATABASE_TYPE='postgres'
# 数据库 host
DATABASE_HOST='localhost'
# 数据库端口。postgres 默认端口是 5432。
DATABASE_PORT=5432
# 数据库用户名
DATABASE_USERNAME=postgres
# 数据库密码
DATABASE_PASSWORD=postgres
# 数据库名
DATABASE_DATABASE=rss-impact
# Postgre Schema 名称，默认是 "public".
DATABASE_SCHEMA='public'
# 带有 ssl 参数的对象
DATABASE_SSL=false

注意：首次连接时会创建数据表。在 data/database.lock.json 文件存在时不会同步数据表结构。

如果希望更新数据表结构，请删除 data/database.lock.json 文件。

特别提醒：更新数据表结构可能会导致数据丢失，请提前做好备份！