KurrentDB on Lazycat

访问入口 Entry Points

HTTP / AtomPub API

通过 REST/Atom 接口直接读写流，浏览器或自动化脚本均可使用。 Use REST/Atom endpoints for stream reads and writes via browsers or automation.

gRPC / TCP Clients

使用 SDK 或 EventStore 协议连接 1112/1113 端口处理实时订阅。 Connect via SDK/EventStore protocol on ports 1112/1113 for realtime subscriptions.

Endpoint: host:1113

实例域名 Instance host

本页即为管理入口，可直接复制当前域名用于 API 与工具配置。 This page already acts as the management landing; reuse the detected host for any tooling.

Host: detecting...

快速验证 Quick Verification

命令行追加事件 Append via shell

确认 AtomPub 开启并已设置 admin / changeit。 Ensure AtomPub is enabled and default credentials are active.
执行以下 curl 命令，向 demo-stream 追加事件。 Run the following curl command to append to demo-stream.
在 Web 控制台或 /streams/demo-stream 中确认数据。 Verify the event through the console or /streams/demo-stream.

curl ...

快速读取事件 Read events fast

使用默认凭据调用 streams 接口。 Call the streams endpoint with the default credentials.
示例命令会携带 Accept: application/json 并获取最新 20 条事件。 The sample uses Accept: application/json and fetches the latest 20 events.
可将 demo-stream 替换为业务流名称。 Replace demo-stream with your business stream.

curl ...

HTTP API 调试助手 HTTP API Testing Helper

当此页面通过 HTTPS 打开时，浏览器会禁止从 https:// 页面向 http:// API 发起请求，导致在线调试工具报 Mixed Content。请使用下方的离线助手。 When this page loads over HTTPS, browsers block calls from https:// to http:// APIs, producing Mixed Content errors. Please use the offline helper below.

使用方法: How to use:

点击下方"下载调试助手"按钮，将自动下载包含当前服务地址的 HTML 文件 Click "Download Helper" to download HTML with current service URL pre-configured
用浏览器打开下载的 HTML 文件（可以使用 file:// 协议，无需 Web 服务器） Open the downloaded HTML file in browser (works with file:// protocol, no web server needed)
服务地址已经预填好，可以直接开始调试 API Service URL is pre-filled, ready to debug API immediately

下载调试助手 Download Helper

服务地址: detecting... Service URL: detecting...

持久化路径 Persistence paths

Lazycat 已将容器内部目录映射到宿主机，方便备份与迁移: Lazycat maps these container directories to the host for easy backup:

用途 Purpose	Container	Host
数据块 / 索引 Data chunks / index	`/var/lib/kurrentdb`	`/data/appvar/cloud.lazycat.app.liu.kurrentdb/kurrentdb-volume-data`
日志 / traces Logs / traces	`/var/log/kurrentdb`	`/data/appvar/cloud.lazycat.app.liu.kurrentdb/kurrentdb-volume-logs`

可在 Lazycat 控制台的“文件”标签直接浏览上述目录，或挂载到备份系统。 Navigate these paths via the Lazycat console “Files” tab or mount them to your backup system.

常用 API 与排障 Useful APIs & troubleshooting

运维命令 Operational calls

GET /info — 节点摘要node summary
GET /stats — 性能指标performance counters
GET /streams/%24all — 巡检系统事件inspect system events
GET /projections/any?name=... — 管理投影manage projections

排障提示 Troubleshooting

Mixed Content: 请改用 HTTP 打开 helper 或复制离线版。 Mixed Content: Open the helper via HTTP or the offline copy.
401/403: 确认 Basic Auth 与 EnableAtomPubOverHTTP。 401/403: Verify Basic Auth and EnableAtomPubOverHTTP.
500: 查看 /var/log/kurrentdb 宿主机映射以获取堆栈。 500: Check the mapped /var/log/kurrentdb for stack traces.
网络: 若自定义域穿透，请更新反向代理的 2113 端口。 Networking: expose port 2113 via your reverse proxy when using custom domains.