You cannot select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.
---
sidebar_position: 6
title: 手动部署
---
:::caution
本章内容需要你对 nodejs, git, linux 有一定程度的了解。当出现如依赖问题、环境问题、系统问题等问题时需要具备自行解决和排查问题的能力。
如果你对此并不了解，不建议你使用本章内容进行部署。建议使用统一镜像进行部署。
:::
## 依赖
- git
- nodejs v16.18.0 或以上
- pnpm v8.3.1 或以上
- mongodb
- redis
- minio
## 下载源码
```bash
&& cd msgbyte
git clone https://github.com/msgbyte/tailchat.git
```
### 切换到稳定代码
因为克隆下来的代码是最新代码， ，
如切换到`v1.7.6`则可以使用命令:
```bash
```
## 编译项目
Tailchat 是一个前后端分离的项目。因此我们要分别处理前端代码和后端代码
### 安装依赖
我们假设你已经安装了 `nodejs v16.18.0+` 或者以上的版本。以及安装了 `pnpm v8.3.1` 或以上版本
```bash
cd tailchat
pnpm install
```
该命令会花费一些时间，
### 构建项目
```bash
NODE_ENV = production pnpm build
```
该命令会并行执行编译前端后端管理端的命令。并将前端产物移动到服务端的 `server/dist/public` 目录
当项目构建完毕后我们的产物就可以正常运行了
:::caution
请尽可能在 `macos` / `linux` 环境进行构建，
:::
## 运行项目
为了确保项目能够水平扩容，`Tailchat` 的核心代码虽然写在同一个项目中，但是实际启动起来的时候可以被划分为多个细分的微服务。通过传入不同的环境变量的组合来实现有选择的启用不同的服务。
在server目录下以`.env.example`目录为例创建一个环境变量文件
```bash
vim .env
```
将必要的环境变量修改为自己的，如 `MONGO_URL` , `REDIS_URL` , `MINIO_URL`
然后启动服务
```bash
SERVICEDIR = services,plugins pnpm start:service
```
> `SERVICEDIR` 表示加载微服务的目录