本地部署Affine
# 本地部署Affine
环境:【win10】 + 【c++开发环境】 + 【node22】 + 【rust环境】 + 【pg16】 + 【redis5+】
# 前置环境准备
C++环境准备:Microsoft C++ 生成工具 - Visual Studio (opens new window)
rust环境准备:安装 Rust - Rust 程序设计语言 (opens new window)
下载exe文件后直接双击运行,选择默认安装项即可
安装后检测:
cargo --version
rustc --version
rustup --version
1
2
3
2
3
pg16环境准备:EDB: Open-Source, Enterprise Postgres Database Management (opens new window)
双击运行后安装即可
redis环境准备:我采用docker安装
docker run --name my-redis -p 6379:6379 -d --restart=always redis --requirepass "123456"
1
# 项目克隆
克隆最新的项目代码到本地
git clone https://github.com/toeverything/AFFiNE.git --depth=1
1
# 依赖下载与构建
本地构建目的是用于启动前后端,web和server
由于server依赖一些模块,所以需要构建多个模块
cd AFFiNE
yarn install
1
2
2
这是正常下载完成的界面
接着构建reader模块(server依赖)路径:D:\temp\AFFiNE\packages\common\reader
cd packages/common/reader
yarn build
1
2
2
有些报错,不用担心,这并不影响运行server服务
构建native模块(server需要)路径:D:\temp\AFFiNE\packages\backend\native
cd packages/backend/native
yarn build
1
2
2
# 数据库创建
连接到之前下载的pg,创建1个数据库
psql.exe -U postgres
CREATE DATABASE affine1;
1
2
2
# 修改后端配置信息
cd packages/backend/server
1
复制1个.env出来
.env
DATABASE_URL=postgresql://postgres:123456@localhost:5432/affine1
PORT=3000
NODE_ENV=development
# 虚拟机IP
REDIS_SERVER_HOST=10.0.0.88
REDIS_SERVER_PASSWORD=123456
1
2
3
4
5
6
7
2
3
4
5
6
7
# 初始化数据库
cd packages\backend\server
yarn prisma generate
yarn prisma migrate dev --name init
1
2
3
2
3
如果在执行命令时出现了这个错误,需要先给pg安装扩展
# PG安装扩展
以管理员身份启动CMD
call "C:\Program Files\Microsoft Visual Studio\2022\Community\VC\Auxiliary\Build\vcvars64.bat"
# 改成你的pg地址
set "PGROOT=D:\soft\soft1\pg"
cd %TEMP%
git clone --branch v0.7.3 https://github.com/pgvector/pgvector.git
cd pgvector
nmake /F Makefile.win
nmake /F Makefile.win install
1
2
3
4
5
6
7
8
2
3
4
5
6
7
8
再去执行《初始化数据库》里报错的命令会报错,此时需要处理下缓存问题:
这个文件夹全部删掉
先在pg将数据库affine1删掉重建,然后在命令行执行:
cd packages/backend/server
yarn prisma migrate dev --name init
1
2
2
# 启动前后端
来到项目根目录
启动后端:
yarn dev
# 选server
1
2
2
启动前端:
yarn dev
# 选web
1
2
2
这些小警告目前可以忽略,主打的就是个能用就行
# 访问web

上次更新: 8/22/2025, 10:15:41 AM