验证时截图 · 点击放大
应用测试已通过;AWS 环境证据来自引用的平台验证记录。
该版本在成为公开版本前,先在真实一次性 AWS 栈上核对过:注入的应用地址与私有访问一致、镜像用户对数据目录可写。它不覆盖完整业务验收,也不签发可信 TLS 证书。
快速部署
可直接使用推荐配置,也可按需调整。
推荐配置
- 部署版本
- v2.7.0
- AWS 区域
- us-east-1
- 规格
- t3.small
- 持久化数据卷
- 30 GB
自定义配置
可调整版本、区域和资源规格;扩容后的资源组合未单独验证。
创建资源前,请先准备好
以下由你自行确认,并非系统预检。本站无法检查你的 AWS 账号,也不会索取 AWS 访问密钥。
- 准备好 AWS 账号,以及在 us-east-1 创建 CloudFormation、IAM、VPC、EC2、EBS 和日志资源的权限;先为持续运行的实例设定预算。
- 默认通过私有通道访问。本机需安装 AWS CLI 和 Session Manager 插件,登录同一 AWS 账号,并具备启动 SSM 会话的权限;本机 8080 端口需空闲。
- 私有访问不需要域名。后续如需让用户通过 HTTPS 访问,须准备可管理 DNS 的域名,并先在私有通道中完成管理员初始化。
估算成本 · ≈ $23/月us-east-1 已验证默认配置:t3.small 约 $15.2/月 + 20GB 系统盘与 30GB 数据盘 gp3 约 $4/月 + 公网 IPv4 约 $3.65/月。这是估算,不是报价或费用上限。请核对区域、系统盘、数据盘和公网 IPv4;流量、快照和日志另计。修改配置后需重新估算。
删除 CloudFormation 栈会终止主机,但数据卷会被保留并继续计费。请先创建快照;确认不再需要后,再手动删除保留卷。
部署流程与部署后操作
创建资源、连接应用、完成初始化
以下是操作指引,不代表本站已检测到部署成功。栈创建完成、应用可访问、管理员初始化完成是三个不同阶段。
- 在 CloudFormation 中核对栈「corenova-vikunja-v2-7-0」。保留私有访问参数及锁定的镜像,确认费用与 IAM 授权提示后,再点击「创建堆栈」。
- 等待 CREATE_COMPLETE,通常约 10 分钟。如创建失败或回滚,先查看 Events 中的原因,不要直接重复建栈。
- 打开栈的 Outputs 标签:
InstanceId实例 ID——用于打开 SSM 终端或定位主机SSMPortForwardCommand端口转发命令——在本机执行并保持会话ResolvedLaunchUrl私有访问地址——建立 SSM 隧道后再打开
- 将 SSMPortForwardCommand 复制到本机终端执行并保持会话,再用浏览器打开 http://localhost:8080。公网 IP 不是默认的应用入口。
该命令通过 SSM 将本机 8080 端口转发到实例的 80 端口,不开放 22 端口。关闭终端会中断访问;请使用部署时的 AWS 账号和区域。
- 管理后台 — 在访问地址后拼接该路径打开:
/register注册的第一个账户即实例管理员;没有预置账号密码。
- 通过私有通道完成应用的首次设置,再退出并重新登录,确认管理员账号可用。CREATE_COMPLETE 不代表管理员已经创建。
可选:启用带访问保护的 HTTPS
私有初始化完成后,将域名 DNS 指向实例,为证书验证放行 80 端口,并按访问需要放行 443 端口,再打开 SSM 终端。替换下方示例域名与邮箱后执行:
sudo /opt/corenova/bin/enable-https.sh app.example.com [email protected] --confirm-initialized脚本申请可信证书并配置续期;失败时应保留私有访问。HTTPS 仍有额外的代理登录保护,凭据仅通过 SSM 从 /opt/corenova/credentials/admin.txt 领取。这不等于已开放匿名网站或外部 Webhook。
访问、HTTPS 与故障排查如果某一步失败
- 权限不足、回滚或初始化超时:打开 CloudFormation → Events,找到最早的 CREATE_FAILED 资源及原因;查清前不要重复创建多个栈。
- 无法连接或访问被拒:核对 SSM 会话、账号、区域及本机 8080 端口。域名、证书或管理员设置出错时,继续用私有通道排查,不要改成公网 HTTP 绕过问题。
- 求助时提供应用版本、区域、失败资源名和脱敏错误,不要提供密码、访问密钥、会话令牌或完整原始日志。退出时清理失败栈,并检查仍在计费的资源。
注意事项
- SQLite 与附件共用 /db,不更换数据库引擎。更新已有部署前,先备份数据库并导出 /app/vikunja/files 中的附件,在副本上恢复验证后再切换;更换模板不会迁移容器内文件。
- 数据库(SQLite)与附件保存在保留数据卷(/db)中。删除栈后该卷仍会计费;请先创建快照,不再需要时再删除卷。
版本
查看完整版本历史| 版本 | 验证时间 | 已验证 | 状态 | AWS 测试 |
|---|---|---|---|---|
| v2.7.0 | 2026年10月2日 | 已验证 | 新版本 | AWS · 引用 |
| v2.6.0 | 2026年9月24日 | 已验证 | 新版本 | AWS · 引用 |
技术信息
常见问题
部署后如何访问Vikunja 任务管理?
栈达到 CREATE_COMPLETE 后,在本机终端运行 Outputs 中的 SSMPortForwardCommand 并保持连接,再打开 http://localhost:8080 私下完成应用初始化。公网访问默认关闭,需另行启用 HTTPS。 注册的第一个账户即实例管理员;没有预置账号密码。
应用数据和凭据保存在哪里?
容器内的 /db 挂载自加密 EBS 数据卷;删栈后数据卷保留并继续计费,保留不等于备份。平台代理凭据及主机配置位于系统盘,不包含在数据卷快照中。删除资源前请按备份指南核对数据。