Skip to main content

自建服务：安装

如果你希望数据完全由自己掌控、或需要给小团队一起用，可以选择自建 Vocnet 服务。

这份文档尽量用“普通用户也能照着做”的方式写：推荐 Docker，一条命令即可启动。

你需要准备什么​

  • 一台服务器（家里 NAS/云服务器都可以）
    • 建议：2 核 CPU、2GB 内存、10GB 可用磁盘
  • 一个域名（可选，但强烈建议有）
  • 已安装 Docker 与 Docker Compose

如果你暂时没有域名，也可以先用 IP + 端口在内网/小范围使用。

快速启动（Docker Compose）​

1) 新建目录​

在服务器上找个目录，例如：

mkdir -p vocnet && cd vocnet

2) 创建 docker-compose.yml​

把下面内容保存为 docker-compose.yml（先用默认配置跑起来，后续再慢慢优化）：

services:
  db:
    image: postgres:16-alpine
    environment:
      POSTGRES_DB: vocnet
      POSTGRES_USER: vocnet
      POSTGRES_PASSWORD: change_me
    volumes:
      - vocnet_db:/var/lib/postgresql/data
    restart: unless-stopped

  vocnet:
    image: eslsoft/vocnet:latest
    ports:
      - "8080:8080"
    environment:
      DB_DSN: "postgres://vocnet:change_me@db:5432/vocnet?sslmode=disable"
    depends_on:
      - db
    restart: unless-stopped

volumes:
  vocnet_db:

3) 启动​

docker compose up -d

4) 访问​

  • 在浏览器打开：http://你的服务器IP:8080

建议下一步立刻做两件事：

  1. 配置域名与 HTTPS（更安全、更稳定）：见 自建服务：配置
  2. 设置备份（避免意外）：见 自建服务：备份与迁移

常见问题​

我不想暴露到公网​

可以只在内网使用（例如 NAS、家用服务器），不要做端口转发；或者用 VPN/内网穿透把访问限制在自己设备。

启动后打不开网页​

先检查三件事：

  • 服务器防火墙是否放行 8080 端口
  • docker compose ps 是否显示服务为 running
  • docker compose logs vocnet 是否有报错