
listmonk 首次启动后如何访问 http://localhost:9000 创建 Super Admin 并登录【免费下载链接】listmonkHigh performance, self-hosted, newsletter and mailing list manager with a modern dashboard. Single binary app.项目地址: https://gitcode.com/GitHub_Trending/li/listmonklistmonk 是一个自托管、单二进制的新spaper/邮件列表管理应用唯一的依赖是 Postgres 数据库。把它跑起来之后还差最后一步第一次访问http://localhost:9000创建 Super Admin超级管理员账户并登录。本文覆盖从启动二进制或 Docker 容器到在网页上完成 Super Admin 创建并成功登录的完整路径以及两条路径下为什么没看到创建页面这类常见情况。前置条件listmonk 需要一套可用的 Postgres 实例二进制安装要求 Postgres ⩾ 12Docker Compose 方式则自带数据库容器无需单独准备。两种启动方式都监听同一个地址默认localhost:9000。路径一运行 listmonk 二进制按 安装文档 的顺序执行下载最新 release解压出 listmonk 二进制。amd64是主流版本适用于 Intel 和 x86 CPU。生成配置文件并编辑./listmonk --new-config会生成config.toml需要修改其中的数据库连接信息[db]段的 host、port、user、password、database指向你的 Postgres。参考 config.toml.sample默认值示例为user listmonk、password listmonk、database listmonk、ssl_mode disable。[app]段的address默认为localhost:9000即只从当前机器监听如需外部访问改为0.0.0.0:9000。安装数据库表结构./listmonk --install启动./listmonk程序输出setup complete并提示访问 dashboard 的地址取自app.address配置后就可以打开浏览器访问http://localhost:9000。注意不带--idempotent的--install在终端会提示IMPORTANT: This will wipe existing listmonk tables and types in the DB database即会清空数据库中已有的 listmonk 表。首次安装空库没有影响对已有数据执行前请确认。路径二Docker Compose文档推荐方式仓库内的 docker-compose.yml 与官方文档给出的 compose 文件一致包含 app 和 db 两个服务app 使用listmonk/listmonk:latest镜像并映射9000:9000端口db 使用postgres:17-alpine仅绑定在127.0.0.1:5432。# 在当前目录准备好 docker-compose.yml可用官方文档提供的 curl 命令下载或直接复制本仓库中的文件 docker compose up -dcompose 文件中的command:已经串好了完整流程./listmonk --install --idempotent --yes --config ./listmonk --upgrade --yes --config ./listmonk --config 。其中--config 表示配置全部来自LISTMONK_*环境变量--install --idempotent保证只在空库的首次启动时执行一次建表之后拉取新镜像时由--upgrade自动跑迁移。启动完成后同样访问http://localhost:9000。如果要修改对外暴露的端口把端口映射改成$custom_port:9000的形式。首次访问创建 Super Admin如果安装时没有通过环境变量创建管理员第一次访问http://localhost:9000不会直接显示登录页而是显示 Super Admin 创建页面页面文案为This is a fresh install. Pick a username and password for the Super Admin account.表单包含 4 个必填项email邮箱地址username用户名至少 3 个字符password密码至少 8 个字符password2重复密码需与 password 一致。提交后listmonk 会自动创建一个名为 Super Admin 的角色拥有全部权限并用你填的用户名、密码、邮箱创建对应的超级管理员用户然后直接登录进入管理面板无需再走一次登录。登录与验证创建完成后如何确认一切正常提交表单后浏览器被重定向进管理面板即说明 Super Admin 创建并登录成功刷新或退出后再访问http://localhost:9000此时显示的是 listmonk 自带的登录页URI 为/admin/login用刚创建的用户名和密码即可登录如果安装日志里出现过no superadmin user created. Visit webpage to create user.说明管理员尚未创建需要回到上一步在网页上完成创建。可选安装时直接用环境变量创建 Super Admin两条路径都支持在首次安装时跳过网页创建改用环境变量见 安装文档 中的提示# 二进制方式 LISTMONK_ADMIN_USERmyuser LISTMONK_ADMIN_PASSWORDxxxxx ./listmonk --install# Docker 方式仅在第一次 up 时设置才生效 LISTMONK_ADMIN_USERmyuser LISTMONK_ADMIN_PASSWORDxxxxx docker compose up -d约束与注意事项LISTMONK_ADMIN_USER至少 3 个字符LISTMONK_ADMIN_PASSWORD至少 8 个字符不满足时安装直接失败Docker 方式下这两个变量只在第一次启动时生效之后再设置不会新建用户走了这条路径后首次访问http://localhost:9000显示的就是登录页而不是创建页面——这是预期行为不是故障直接用myuser登录即可。常见问题与限制看不到创建页面直接是登录页通常是首次启动时已经设置了LISTMONK_ADMIN_USER/LISTMONK_ADMIN_PASSWORDSuper Admin 已被自动创建。用环境变量里的凭据登录。本机浏览器打不开但其他机器能打开或反过来检查[app]的address配置。默认localhost:9000只接受当前机器的连接Docker 的 compose 文件里 app 使用0.0.0.0:9000并映射9000:9000所以容器场景下本机http://localhost:9000可访问。想升级而不是重装升级已有数据库应使用./listmonk --upgrade幂等多次执行无副作用Docker 场景见 升级文档。完成登录并进入面板后就可以继续创建列表、订阅者和邮件计划后续版本升级按 升级文档 操作升级前务必备份 Postgres 数据库。【免费下载链接】listmonkHigh performance, self-hosted, newsletter and mailing list manager with a modern dashboard. Single binary app.项目地址: https://gitcode.com/GitHub_Trending/li/listmonk创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考