Files
sillytavern-repalice/DISTRIBUTION-GUIDE.md
2026-04-26 03:34:47 +08:00

113 lines
1.7 KiB
Markdown

# SillyTavern Repalice - 快速启动指南
## 🚀 快速开始
### 前置要求
- 安装 [Docker](https://www.docker.com/products/docker-desktop/)
- 安装 [Docker Compose](https://docs.docker.com/compose/install/)
### 启动应用
```bash
# 克隆仓库
git clone <repository-url>
cd sillytavern-repalice
# 配置环境变量(可选)
cp .env.example .env
# 编辑 .env 文件,填入您的 API 密钥
# 启动应用
docker-compose up -d
# 查看日志
docker-compose logs -f
```
### 访问应用
- **前端**: http://localhost:23337
- **后端**: http://localhost:3000
### 停止应用
```bash
docker-compose down
```
## 📝 配置说明
### 环境变量
编辑 `.env` 文件:
```env
# LLM API 配置
OPENAI_API_KEY=your-api-key-here
ANTHROPIC_API_KEY=your-api-key-here
# 其他配置
NODE_ENV=production
PORT=3000
DATA_DIR=./data
```
### 数据持久化
所有数据存储在 `./data` 目录,包括:
- 角色卡
- 聊天记录
- 世界书
- 预设配置
## 🔧 常见问题
### Q: 端口被占用怎么办?
修改 `docker-compose.yml` 中的端口映射:
```yaml
ports:
- "23338:80" # 将前端改为 23338 端口
- "8081:3000" # 将后端改为 8081 端口
```
### Q: 如何更新到最新版本?
```bash
docker-compose pull
docker-compose up -d
```
### Q: 如何查看日志?
```bash
# 查看所有日志
docker-compose logs -f
# 只查看前端日志
docker-compose logs -f frontend
# 只查看后端日志
docker-compose logs -f backend
```
### Q: 如何备份数据?
```bash
# 备份 data 目录
tar -czf backup.tar.gz ./data
# 恢复数据
tar -xzf backup.tar.gz
```
## 📞 获取帮助
如有问题,请提交 Issue 或联系开发者。
---
**祝您使用愉快!** 🎉