这份指南面向没有编程经验的博客作者。项目启动后,你只需要使用浏览器后台,不需要修改源码、数据库文件或配置文件。
打开博客地址,在网址后加上 /admin,例如:
http://localhost:3001/admin
第一次进入时,页面会让你创建管理密码。设置完成后,这个密码就是后台登录凭据。
- 点击左侧“写新文章”;
- 输入标题、摘要、分类和标签;
- 在正文区域直接输入内容;
- 使用工具栏插入标题、列表、引用、链接、按钮、代码块、表格或双栏内容;
- 点击“保存版本”保留草稿,或点击“立即发布”。
编辑器会自动保存。正文中的顶层区块可以拖动调整顺序。
- 草稿:只有后台管理员可以看到;
- 私密预览:保存后生成分享链接,适合发布前交给朋友审阅;
- 公开展示:出现在首页、搜索和归档中;
- 仅链接可见:不进入公开文章列表,知道链接的人可以阅读;
- 密码文章:读者输入文章密码后才能阅读;
- 定时发布:选择时间后点击“定时发布”。
进入“媒体库”可以批量上传:
- JPG、PNG、WebP 等图片;
- 视频;
- 音频;
- PDF 文件。
大图片会自动压缩。图片可以一键裁成正方形,也可以在不修改文章的情况下替换原文件。
写文章时点击“媒体/画廊”,可以把单个媒体插入正文,或勾选多张图片组成画廊。
进入“站点设置”或“设计编排”:
- 选择整套主题配色和预设图片;
- 修改强调色;
- 切换字体、页面布局和组件风格;
- 关闭不想使用的首页模块;
- 上下移动模块调整首页顺序;
- 修改导航文字和链接。
保存后前台立即更新,不需要编辑 CSS。
- 进入“专栏合集”;
- 填写名称、简介和封面;
- 发布专栏;
- 回到文章编辑器,为文章选择所属专栏和专栏内顺序。
前台会自动生成专栏封面、文章目录和连续阅读的上下篇导航。
“页面建设”提供关于、友链、项目和归档页面模板。填写页面标题和正文即可发布。
友链和项目还可以在“友链项目”中按字段管理:名称、简介、链接、图片和补充信息。前台会自动排版成卡片。
进入“互动订阅”可以:
- 通过或隐藏评论;
- 置顶重要评论;
- 以作者身份回复;
- 删除评论;
- 审核公开留言;
- 阅读联系表单发来的私信。
如果希望先审核再公开,在“站点设置”中打开“新评论先审核再公开”。单篇文章也可以关闭评论。
博客在首页和读者中心提供订阅入口。
如需真正自动发送邮件:
- 注册 Resend 并取得 API Key;
- 在 Resend 中验证发件域名或发件地址;
- 进入后台“互动订阅”;
- 填写发件人和 API Key;
- 打开“发布文章后自动发送”。
以后发布新文章时会自动通知有效订阅者。也可以选择一篇已发布文章手动发送。
读者可以在“我的”页面注册账户。登录后可以跨设备同步:
- 收藏文章;
- 阅读历史;
- 新文章邮件订阅状态。
后台左下角“导出备份”会下载完整 JSON 备份。
“内容导入”支持 Markdown、JSON 和本站备份格式。更换电脑或重新部署前,建议先导出一份备份。
不需要。以下工作都在后台完成:
- 写作和排版;
- 发布、删除和恢复文章;
- 上传与替换媒体;
- 更换主题和首页结构;
- 建立专栏、页面、友链和项目;
- 管理评论、留言和订阅;
- 查看数据与导出备份。
只有第一次安装、连接托管平台或升级项目版本时可能需要终端操作。这些一次性步骤也可以交给 Codex 完成。