Vikunja是Go语言编写的单体二进制服务,不依赖PHP、Apache、Nginx或phpEnv,因此不能用phpEnv安装或运行;其官方支持方式为Docker镜像、原生二进制文件或源码编译,Windows用户可直接下载并运行vikunja.exe或通过WSL2+Docker部署。

Vikunja 不是 PHP 应用,不能用 phpEnv 安装或运行。
它是一个用 Go 编写的单体二进制服务(前后端打包在一起),依赖的是 Go 运行时和数据库(SQLite / MySQL / PostgreSQL),不依赖 PHP、Apache、Nginx 或 phpEnv 的任何组件。试图用 phpEnv 部署 Vikunja 会失败,因为根本不存在 index.php 入口、没有 composer.json、也不走 PHP-FPM 流程。
为什么 phpEnv 不适用于 Vikunja
-
phpEnv是为本地 PHP 开发环境设计的工具链(类似 XAMPP,但聚焦多版本 PHP 切换),核心服务是 Apache/Nginx + PHP + MySQL - Vikunja 的官方分发形态是:
- Docker 镜像(
vikunja/vikunja) - Linux/macOS/Windows 二进制文件(
vikunja可执行文件) - 源码(Go 项目,用
go build编译)
- Docker 镜像(
- 它自带 HTTP 服务(默认监听
:3456),不需要、也不能塞进 PHP 的 Web 服务器里反向代理以外的方式运行
想在 Windows 上本地跑 Vikunja?推荐这几种真实可行的方式
-
直接下载 Windows 二进制:
- 访问 https://www.php.cn/link/6c6bea31aa6f6df3b292c729e98d024c
- 下载
vikunja-latest-windows-amd64-full.zip - 解压后双击运行
vikunja.exe(会自动用 SQLite 启动) - 浏览器打开
@#@#@#@#@#@#@#@#@#@1
-
用 WSL2 + Docker(比 phpEnv 更轻、更贴近生产):
- 在 WSL2 中安装 Docker Desktop for Windows
- 执行:
docker run -p 3456:3456 -v $(pwd)/vikunja-data:/app/vikunja/files vikunja/vikunja
- 注意:不要加
-v映射数据库目录时忽略权限问题,SQLite 文件需由 UID 1000 写入
-
如果你坚持用 Windows 原生环境且已有 phpEnv,唯一能“共存”的方式是反向代理:
- 启动 Vikunja(如监听
127.0.0.1:3456) - 修改 phpEnv 自带的 Apache 或 Nginx 配置,添加反向代理规则:
ProxyPass /vikunja http://127.0.0.1:3456
- 但注意:Vikunja 默认不支持子路径部署(
/vikunja),需额外设置VIKUNJA_SERVICE_BASEURL环境变量并重建前端资源——这已超出开箱即用范围,容易出404或静态资源加载失败
- 启动 Vikunja(如监听
常见错误现象与对应原因
-
访问
@#@#@#@#@#@#@#@#@#@2(phpEnv 默认端口)看到空白页或 404:- 因为 Vikunja 没在 Apache/Nginx 下运行,也没放任何文件到
www/目录
- 因为 Vikunja 没在 Apache/Nginx 下运行,也没放任何文件到
-
把
vikunja.exe放进 phpEnv 的www/目录并尝试访问:- 浏览器会直接下载该文件,或报错「无法执行二进制」——Web 服务器不会执行 .exe
-
使用 phpEnv 的 MySQL 作为 Vikunja 数据库:
- 可以,但必须通过网络连接(
VIKUNJA_DATABASE_HOST=127.0.0.1),不能用 socket;且要确保 MySQL 用户授权、数据库已创建、字符集为utf8mb4
- 可以,但必须通过网络连接(
真正卡住的地方往往不是“怎么装”,而是误判了应用类型——Vikunja 和 PHP 生态不在同一技术栈上,硬套 phpEnv 只会浪费调试时间。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











