{"id":47706098,"url":"https://github.com/oceanbase/homebrew-seekdb","last_synced_at":"2026-04-02T17:58:25.251Z","repository":{"id":336407004,"uuid":"1145879038","full_name":"oceanbase/homebrew-seekdb","owner":"oceanbase","description":null,"archived":false,"fork":false,"pushed_at":"2026-03-31T06:19:45.000Z","size":9,"stargazers_count":1,"open_issues_count":0,"forks_count":1,"subscribers_count":0,"default_branch":"master","last_synced_at":"2026-03-31T08:36:29.163Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Ruby","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/oceanbase.png","metadata":{"files":{"readme":"README-CN.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-01-30T10:29:30.000Z","updated_at":"2026-03-31T06:19:49.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/oceanbase/homebrew-seekdb","commit_stats":null,"previous_names":["oceanbase/homebrew-seekdb"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/oceanbase/homebrew-seekdb","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oceanbase%2Fhomebrew-seekdb","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oceanbase%2Fhomebrew-seekdb/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oceanbase%2Fhomebrew-seekdb/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oceanbase%2Fhomebrew-seekdb/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/oceanbase","download_url":"https://codeload.github.com/oceanbase/homebrew-seekdb/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oceanbase%2Fhomebrew-seekdb/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31312744,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-02T12:59:32.332Z","status":"ssl_error","status_checked_at":"2026-04-02T12:54:48.875Z","response_time":89,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-04-02T17:58:24.633Z","updated_at":"2026-04-02T17:58:25.242Z","avatar_url":"https://github.com/oceanbase.png","language":"Ruby","funding_links":[],"categories":[],"sub_categories":[],"readme":"# SeekDB Homebrew 安装包\n\n本目录包含 OceanBase SeekDB 的 Homebrew 安装配置。\n\n## 目录结构\n\n```\nhomebrew-seekdb/\n├── Formula/\n│   └── seekdb.rb              # Homebrew formula\n└── README.md                  # 本文档\n```\n\n## 安装\n\n### 使用 Homebrew Tap 安装\n\n```bash\n# 添加 tap（如果还没有添加）\nbrew tap oceanbase/seekdb\n\n# 安装 SeekDB\nbrew install seekdb\n```\n\n安装完成后，SeekDB 会自动创建以下目录结构：\n- 数据目录: `/opt/homebrew/var/seekdb/data`\n- PID 文件: `/opt/homebrew/var/seekdb/run/seekdb.pid`\n- 日志文件: `/opt/homebrew/var/seekdb/data/log/seekdb.log`\n\n## 使用方法\n\n### 启动 SeekDB\n\n#### 方式 1: 使用管理命令（推荐）\n\n```bash\nseekdb-start\n```\n\n这会以后台守护进程方式启动 SeekDB，并自动：\n- 检查是否已经运行\n- 创建必要的目录\n- 写入 PID 文件\n- 将日志输出到日志文件\n\n#### 方式 2: 前台模式（用于调试）\n\n```bash\nseekdb --nodaemon\n```\n\n前台模式首次启动会比较快，适合调试和开发。\n还可以自定义数据目录\n\n```bash\nseekdb --base-dir=/custom/path\n```\n\n### 停止 SeekDB\n\n#### 方式 1: 使用管理命令（推荐）\n\n```bash\nseekdb-stop\n```\n\n这会：\n- 读取 PID 文件\n- 使用 `kill -KILL` 强制终止进程\n- 清理 PID 文件\n\n### 检查状态\n\n#### 方式 1: 使用管理命令（推荐）\n\n```bash\nseekdb-status\n```\n\n这会显示：\n- 进程是否运行\n- PID 信息\n- 数据目录、PID 文件、日志文件路径\n- 进程详细信息（CPU、内存、运行时间等）\n\n#### 方式 3: 检查进程\n\n```bash\n# 检查 PID 文件\ncat /opt/homebrew/var/seekdb/run/seekdb.pid\n\n# 或使用 ps\nps aux | grep seekdb\n```\n\n### 连接数据库\n\n```bash\n# 使用 MySQL 客户端\nmysql -h 127.0.0.1 -P 2881 -u root\n\n# 或使用 mycli (更好的命令行体验)\nmycli -h 127.0.0.1 -P 2881 -u root\n```\n\n## 文件路径\n\n使用 Homebrew 安装时，默认路径如下：\n\n### Apple Silicon Mac (M1/M2/M3)\n- 数据目录: `/opt/homebrew/var/seekdb/data`\n- PID 文件: `/opt/homebrew/var/seekdb/run/seekdb.pid`\n- 日志文件: `/opt/homebrew/var/seekdb/data/log/seekdb.log`\n- 二进制文件: `/opt/homebrew/bin/seekdb`\n- 管理命令: `/opt/homebrew/bin/seekdb-start`, `/opt/homebrew/bin/seekdb-stop`, `/opt/homebrew/bin/seekdb-status`\n\n### Intel Mac\n- 数据目录: `/usr/local/var/seekdb/data`\n- PID 文件: `/usr/local/var/seekdb/run/seekdb.pid`\n- 日志文件: `/usr/local/var/seekdb/data/log/seekdb.log`\n- 二进制文件: `/usr/local/bin/seekdb`\n- 管理命令: `/usr/local/bin/seekdb-start`, `/usr/local/bin/seekdb-stop`, `/usr/local/bin/seekdb-status`\n\n## 端口说明\n\n| 端口 | 用途 |\n|------|------|\n| 2881 | MySQL 协议端口 |\n\n## 依赖项\n\nSeekDB 依赖以下 Homebrew 包：\n- `zstd` - 压缩库\n- `utf8proc` - UTF-8 处理库\n- `thrift` - RPC 框架\n- `re2` - 正则表达式库\n- `brotli` - 压缩算法\n\n这些依赖会在安装 SeekDB 时自动安装。\n\n## 故障排除\n\n### SeekDB 启动失败\n\n1. **检查端口是否被占用**:\n```bash\nlsof -i :2881\n```\n\n2. **检查日志文件**:\n```bash\n# 查看日志\ntail -f /opt/homebrew/var/seekdb/data/log/seekdb.log\n\n# 或\ncat /opt/homebrew/var/seekdb/data/log/seekdb.log\n```\n\n3. **检查 PID 文件**:\n```bash\n# 如果 PID 文件存在但进程不存在，可能是残留文件\ncat /opt/homebrew/var/seekdb/run/seekdb.pid\n\n# 清理残留 PID 文件\nrm /opt/homebrew/var/seekdb/run/seekdb.pid\n```\n\n4. **检查磁盘空间**:\n```bash\ndf -h\n```\n\n### 权限问题\n\n```bash\n# 确保数据目录有正确权限\nchmod -R 755 /opt/homebrew/var/seekdb\n```\n\n### macOS 安全设置\n\n如果 macOS 阻止应用运行：\n1. 打开\"系统偏好设置\" \u003e \"安全性与隐私\"\n2. 点击\"仍要打开\"或\"允许\"来允许 SeekDB 运行\n\n### 内存不足\n\nSeekDB 最低需要 2GB 内存。检查系统内存:\n```bash\nsysctl hw.memsize\n```\n\n### 后台启动较慢\n\n首次后台启动可能需要约 10 秒，这是正常的 macOS 线程优先级优化行为。如果需要快速启动，可以使用前台模式：\n```bash\nseekdb --nodaemon\n```\n\n## 卸载\n\n```bash\n# 停止服务\nseekdb-stop\n\n# 卸载 SeekDB\nbrew uninstall seekdb\n\n# 删除数据目录（可选，会删除所有数据）\nrm -rf /opt/homebrew/var/seekdb\n```\n\n## 版本信息\n\n- 当前版本: 1.0.0\n- Homepage: https://github.com/oceanbase/seekdb\n- License: Apache-2.0\n\n## 相关链接\n\n- [OceanBase SeekDB](https://github.com/oceanbase/seekdb)\n- [Homebrew Formula Cookbook](https://docs.brew.sh/Formula-Cookbook)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foceanbase%2Fhomebrew-seekdb","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Foceanbase%2Fhomebrew-seekdb","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foceanbase%2Fhomebrew-seekdb/lists"}