mirror of https://github.com/fantasticit/think.git
182 lines
3.8 KiB
Markdown
182 lines
3.8 KiB
Markdown
|
# think
|
|||
|
|
|||
|
## 简介
|
|||
|
|
|||
|
Think 是一款开源知识管理工具。通过独立的知识库空间,结构化地组织在线协作文档,实现知识的积累与沉淀,促进知识的复用与流通。同时支持多人协作文档。使用的技术如下:
|
|||
|
|
|||
|
- `MySQL`:数据存储
|
|||
|
- `next.js`:前端页面框架
|
|||
|
- `nest.js`:服务端框架
|
|||
|
- `AliyunOSS`:对象存储
|
|||
|
- `tiptap`:编辑器及文档协作
|
|||
|
|
|||
|
可访问[云策文档帮助中心](https://think.wipi.tech/share/wiki/4e3d0cfb-b169-4308-8037-e7d3df996af3),查看更多功能文档。
|
|||
|
|
|||
|
## 链接
|
|||
|
|
|||
|
[云策文档](https://think.wipi.tech/)已经部署上线,可前往注册使用。
|
|||
|
|
|||
|
## 项目运行
|
|||
|
|
|||
|
本项目依赖 pnpm 使用 monorepo 形式进行代码组织,分包如下:
|
|||
|
|
|||
|
- `@think/config`: 管理项目整体配置
|
|||
|
- `@think/share`:数据类型定义、枚举、配置等
|
|||
|
- `@think/server`:服务端
|
|||
|
- `@think/client`:客户端
|
|||
|
|
|||
|
### pnpm
|
|||
|
|
|||
|
项目依赖 pnpm,请安装后运行(`npm i -g pnpm`)。
|
|||
|
|
|||
|
### 数据库
|
|||
|
|
|||
|
首先安装 `MySQL`,推荐使用 docker 进行安装。
|
|||
|
|
|||
|
```bash
|
|||
|
docker image pull mysql:5.7
|
|||
|
docker run -d --restart=always --name think -p 3306:3306 -e MYSQL_ROOT_PASSWORD=root mysql:5.7
|
|||
|
```
|
|||
|
|
|||
|
然后在 `MySQL` 中创建数据库。
|
|||
|
|
|||
|
```bash
|
|||
|
docker container exec -it think bash;
|
|||
|
mysql -u root -p;
|
|||
|
CREATE DATABASE `think` DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
|
|||
|
```
|
|||
|
|
|||
|
### 本地运行
|
|||
|
|
|||
|
首先,clone 项目。
|
|||
|
|
|||
|
```bash
|
|||
|
git clone --depth=1 https://github.com/fantasticit/think.git your-project-name
|
|||
|
```
|
|||
|
|
|||
|
然后,安装项目依赖。
|
|||
|
|
|||
|
```bash
|
|||
|
pnpm install
|
|||
|
```
|
|||
|
|
|||
|
- 启动项目
|
|||
|
|
|||
|
```bash
|
|||
|
pnpm run dev
|
|||
|
```
|
|||
|
|
|||
|
前台页面地址:`http://localhost:3000`。
|
|||
|
服务接口地址:`http://localhost:5001`。
|
|||
|
协作接口地址:`http://localhost:5003`。
|
|||
|
|
|||
|
如需修改配置,可在 `packages/config/yaml` 下进行配置。
|
|||
|
|
|||
|
### 配置文件
|
|||
|
|
|||
|
默认加载 `dev.yaml` 中的配置(生产环境使用 `prod.yaml` )。
|
|||
|
|
|||
|
```yaml
|
|||
|
# 开发环境配置
|
|||
|
server:
|
|||
|
prefix: "/api"
|
|||
|
port: 5001
|
|||
|
collaborationPort: 5003
|
|||
|
|
|||
|
client:
|
|||
|
assetPrefix: "/"
|
|||
|
apiUrl: "http://localhost:5001/api"
|
|||
|
collaborationUrl: "ws://localhost:5003"
|
|||
|
|
|||
|
# 数据库配置
|
|||
|
db:
|
|||
|
mysql:
|
|||
|
host: "127.0.0.1"
|
|||
|
username: "root"
|
|||
|
password: "root"
|
|||
|
database: "think"
|
|||
|
port: 3306
|
|||
|
charset: "utf8mb4"
|
|||
|
timezone: "+08:00"
|
|||
|
synchronize: true
|
|||
|
|
|||
|
# oss 文件存储服务
|
|||
|
oss:
|
|||
|
aliyun:
|
|||
|
accessKeyId: ""
|
|||
|
accessKeySecret: ""
|
|||
|
bucket: ""
|
|||
|
https: true
|
|||
|
region: ""
|
|||
|
|
|||
|
# jwt 配置
|
|||
|
jwt:
|
|||
|
secretkey: "zA_Think+KNOWLEDGE+WIKI+DOCUMENTS@2022"
|
|||
|
expiresIn: "6h"
|
|||
|
```
|
|||
|
|
|||
|
### 项目部署
|
|||
|
|
|||
|
生产环境部署的脚本如下:
|
|||
|
|
|||
|
```bash
|
|||
|
|
|||
|
node -v
|
|||
|
npm -v
|
|||
|
|
|||
|
npm config set registry http://registry.npmjs.org
|
|||
|
|
|||
|
npm i -g pm2 @nestjs/cli pnpm
|
|||
|
|
|||
|
pnpm install
|
|||
|
pnpm run build
|
|||
|
pnpm run pm2
|
|||
|
|
|||
|
pm2 startup
|
|||
|
pm2 save
|
|||
|
```
|
|||
|
|
|||
|
### nginx 配置
|
|||
|
|
|||
|
采用反向代理进行 `nginx` 配置,**同时设置 `proxy_set_header X-Real-IP $remote_addr;` 以便服务端获取到真实 ip 地址**。
|
|||
|
|
|||
|
```bash
|
|||
|
upstream wipi_client {
|
|||
|
server 127.0.0.1:3000;
|
|||
|
keepalive 64;
|
|||
|
}
|
|||
|
|
|||
|
# http -> https 重定向
|
|||
|
server {
|
|||
|
listen 80;
|
|||
|
server_name 域名;
|
|||
|
rewrite ^(.*)$ https://$host$1 permanent;
|
|||
|
}
|
|||
|
|
|||
|
server {
|
|||
|
listen 443 ssl;
|
|||
|
server_name 域名;
|
|||
|
ssl_certificate 证书存放路径;
|
|||
|
ssl_certificate_key 证书存放路径;
|
|||
|
|
|||
|
location / {
|
|||
|
proxy_http_version 1.1;
|
|||
|
proxy_set_header Upgrade $http_upgrade;
|
|||
|
proxy_set_header Connection "upgrade";
|
|||
|
proxy_set_header Host $host;
|
|||
|
proxy_set_header X-Nginx-Proxy true;
|
|||
|
proxy_cache_bypass $http_upgrade;
|
|||
|
proxy_pass http://wipi_client; #反向代理
|
|||
|
proxy_set_header X-Real-IP $remote_addr;
|
|||
|
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
|
|||
|
}
|
|||
|
}
|
|||
|
```
|
|||
|
|
|||
|
## 资料
|
|||
|
|
|||
|
- next.js 源码:https://github.com/vercel/next.js
|
|||
|
- next.js 文档:https://nextjs.org/
|
|||
|
- nest.js 源码:https://github.com/nestjs/nest
|
|||
|
- nest.js 文档:https://nestjs.com/
|