自托管 LearnHouse 最快的方式是用 Docker 跑在一台服务器上。运行 npx learnhouse@latest setup,回答几个问题,然后运行 npx learnhouse start。CLI 会生成并管理 Docker Compose 文件,你完全不用自己去改。
$ npx learnhouse@latest setup
向导会问什么
$ npx learnhouse start
$ npx learnhouse doctor
npx learnhouse@latest setupnpx learnhouse start大多数问题都有默认值,按 Enter 即可接受。首次启动会拉取镜像,需要一两分钟。
它会写入什么
learnhouse/
docker-compose.yml
所有服务及其卷。
.env
设置项和生成的密钥。
learnhouse.config.json
你的安装设置。
nginx / Caddy
反向代理用的 nginx 或 Caddy 配置。
| 最低 | 推荐 | |
|---|---|---|
| 内存 | 2 GB | 4 GB |
| CPU | 1 | 2+ |
| 磁盘 | 10 GB | 20 GB+ |
生产环境推荐使用 Linux:Ubuntu 20.04+、Debian 11+、CentOS 8+,或任何支持 Docker 的发行版。macOS 可通过 Docker Desktop 运行,Windows 可通过 WSL2 运行。
开放 80 和 443 端口,安装期间需要联网以拉取镜像。
learnhouse backup 会把数据库的 pg_dump 和 .env 副本写入一个带时间戳的归档文件。上传的文件不包含在内,所以还要备份内容卷,或者把上传文件放在 S3 兼容存储中。
什么时候一台服务器就够了
一台服务器能满足大多数学校、培训团队和课程业务。当你需要运行多个 Web 应用和 API 副本,或者公司本来就把所有东西跑在集群上时,再迁移到 Kubernetes。
可以。用 --external-db 传入 PostgreSQL 连接字符串,用 --external-redis 传入 Redis,或在向导中选择 External。
默认存在 Docker 卷中。你可以在 .env 文件中修改三项设置,切换到任何 S3 兼容服务,例如 AWS S3、Cloudflare R2 或 MinIO。
在 .env 文件中设置你的域名和 LEARNHOUSE_SSL=true,然后在前面放一个反向代理。Caddy 会自动申请并续期 Let's Encrypt 证书。
不想自己运维服务器?LearnHouse Cloud 替你运行同样的平台,更新、备份和 TLS 都帮你处理好。
查看 Cloud 方案