tnyr.me 的安装和配置教程

项目基础介绍

tnyr.me 是一个基于开源技术的隐私优先的 URL 短缩器。它提供了端到端的加密，确保链接的隐私安全。这个项目适用于对隐私保护有较高要求的用户和组织。项目主要使用 TypeScript、Python、HTML、JavaScript 和 CSS 等编程语言。

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

• TypeScript: 用于前端开发，提供了类型安全，帮助在开发阶段捕捉错误。
• Python: 后端语言，处理服务器逻辑和数据库操作。
• HTML/CSS/JavaScript: 前端页面构建和交互实现。
• Argon2: 用于生成密码散列，增强安全性。
• AES-256-GCM: 用于加密存储的原始 URL。

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

在开始安装之前，请确保您的系统满足了以下要求：

• Python 3.9 或以上版本
• Node.js 16 或以上版本（前端开发需要）

安装步骤

克隆仓库

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

git clone https://github.com/sevi-py/tnyr.me.git
cd tnyr.me

安装后端依赖

进入后端目录并安装所需的 Python 依赖：

cd backend
pip install -r requirements.txt

配置

在开始之前，您需要配置项目。将 config_template.json 文件重命名为 config.json，然后使用以下命令生成盐值：

python generate_salts.py

将生成的盐值填入 config.json 文件中的相应占位符位置。

启动服务器

配置完成后，您可以通过以下命令启动服务器：

python main.py

现在，您可以通过浏览器访问 http://localhost:5000 来查看您的 URL 短缩器。

前端开发

如果需要修改前端文件，您可以进入前端目录进行以下操作：

cd frontend
npm install
npm run build

这将编译前端资源，并在后端服务中提供。

以上就是 tnyr.me 的安装和配置详细指南，按照这些步骤操作，您应该能够成功部署并运行这个 URL 短缩器。