docs: add landing page and upgrade all documentation with advanced components
- Add product landing page with hero section, stats, feature cards, database badges, comparison table, and screenshots - Register Fumadocs MDX components (Tabs, Steps, Callout, Cards, Accordions) globally - Rewrite all 17 doc pages (CN + EN) with richer content, use cases, and advanced components - Add competitive comparison table (vs DBeaver/Navicat/TablePlus) - Add ~300 lines of responsive landing page CSS
This commit is contained in:
1 parent
d4aeb7af68
commit
89fa8c02be
38 files changed
+2096
-800
No files matched your search
@@ -5,74 +5,118 @@ description: 安装 DBX 并创建你的第一个数据库连接。
|
||||
|
||||
## 安装
|
||||
|
||||
从 [Releases](https://github.com/t8y2/dbx/releases) 页面下载最新版本。
|
||||
<Tabs groupId="platform" items={['macOS', 'Windows', 'Linux', 'Docker']}>
|
||||
<Tab value="macOS">
|
||||
**Homebrew(推荐):**
|
||||
|
||||
### Homebrew (macOS)
|
||||
```bash
|
||||
brew install --cask t8y2/tap/dbx
|
||||
```
|
||||
|
||||
```bash
|
||||
brew install --cask t8y2/tap/dbx
|
||||
```
|
||||
更新:
|
||||
```bash
|
||||
brew upgrade --cask t8y2/tap/dbx
|
||||
```
|
||||
|
||||
更新:
|
||||
```bash
|
||||
brew upgrade --cask t8y2/tap/dbx
|
||||
```
|
||||
也可以从 [Releases](https://github.com/t8y2/dbx/releases) 页面下载 `.dmg` 安装包。
|
||||
</Tab>
|
||||
<Tab value="Windows">
|
||||
**Scoop(推荐):**
|
||||
|
||||
### Scoop (Windows)
|
||||
```bash
|
||||
scoop bucket add dbx https://github.com/t8y2/scoop-bucket
|
||||
scoop install dbx
|
||||
```
|
||||
|
||||
```bash
|
||||
scoop bucket add dbx https://github.com/t8y2/scoop-bucket
|
||||
scoop install dbx
|
||||
```
|
||||
更新:
|
||||
```bash
|
||||
scoop update dbx
|
||||
```
|
||||
|
||||
更新:
|
||||
```bash
|
||||
scoop update dbx
|
||||
```
|
||||
也可以从 [Releases](https://github.com/t8y2/dbx/releases) 页面下载 `.msi` 安装包。
|
||||
</Tab>
|
||||
<Tab value="Linux">
|
||||
从 [Releases](https://github.com/t8y2/dbx/releases) 页面下载对应的安装包(`.deb` / `.AppImage`)。
|
||||
</Tab>
|
||||
<Tab value="Docker">
|
||||
通过 Docker 部署 DBX,适合团队共享和服务器环境:
|
||||
|
||||
### Docker 自托管
|
||||
```bash
|
||||
docker run -d --name dbx -p 4224:4224 -v dbx-data:/app/data t8y2/dbx
|
||||
```
|
||||
|
||||
你也可以通过 Docker 部署 DBX,适合团队共享和服务器环境:
|
||||
部署后通过浏览器访问 `http://localhost:4224` 即可使用。
|
||||
|
||||
```bash
|
||||
docker run -d --name dbx -p 4224:4224 -v dbx-data:/app/data t8y2/dbx
|
||||
```
|
||||
**Docker Compose:**
|
||||
|
||||
部署后通过浏览器访问 `http://localhost:4224` 即可使用。
|
||||
```yaml
|
||||
services:
|
||||
dbx:
|
||||
image: t8y2/dbx
|
||||
ports:
|
||||
- "4224:4224"
|
||||
volumes:
|
||||
- dbx-data:/app/data
|
||||
restart: unless-stopped
|
||||
|
||||
volumes:
|
||||
dbx-data:
|
||||
```
|
||||
</Tab>
|
||||
</Tabs>
|
||||
|
||||
## 创建第一个连接
|
||||
|
||||
1. 点击工具栏的 **新建连接**
|
||||
2. 选择数据库类型(MySQL、PostgreSQL 等)
|
||||
3. 填写主机、端口、用户名、密码
|
||||
4. 点击 **测试** 验证连接
|
||||
5. 点击 **保存并连接**
|
||||
<Steps>
|
||||
<Step>
|
||||
### 新建连接
|
||||
点击工具栏的 **新建连接** 按钮。
|
||||
</Step>
|
||||
<Step>
|
||||
### 选择数据库类型
|
||||
选择你要连接的数据库类型(MySQL、PostgreSQL、SQLite 等)。
|
||||
</Step>
|
||||
<Step>
|
||||
### 填写连接信息
|
||||
填写主机、端口、用户名、密码。如需通过跳板机连接,可启用 [SSH 隧道](/cn/docs/ssh-tunnel)。
|
||||
</Step>
|
||||
<Step>
|
||||
### 测试并保存
|
||||
点击 **测试** 验证连接是否正常,然后点击 **保存并连接**。
|
||||
</Step>
|
||||
</Steps>
|
||||
|
||||
<Callout type="info">
|
||||
连接密码存储在系统钥匙串中(macOS Keychain / Windows 凭据管理器 / Linux Secret Service),不会明文保存在配置文件中。
|
||||
</Callout>
|
||||
|
||||
## 开发环境搭建
|
||||
|
||||
如果你想从源码运行 DBX,请参考以下步骤。
|
||||
|
||||
### 环境要求
|
||||
|
||||
- [Node.js](https://nodejs.org/) >= 18
|
||||
- [pnpm](https://pnpm.io/)
|
||||
- [Rust](https://www.rust-lang.org/tools/install) >= 1.77
|
||||
|
||||
#### 系统依赖
|
||||
### 系统依赖
|
||||
|
||||
**macOS:**
|
||||
|
||||
```bash
|
||||
brew install unixodbc
|
||||
```
|
||||
|
||||
**Linux (Ubuntu/Debian):**
|
||||
|
||||
```bash
|
||||
sudo apt-get install -y libwebkit2gtk-4.1-dev libgtk-3-dev libappindicator3-dev librsvg2-dev patchelf libssl-dev unixodbc-dev
|
||||
```
|
||||
|
||||
**Windows:**
|
||||
|
||||
无需额外安装(ODBC 已内置于 Windows)。
|
||||
<Tabs groupId="dev-platform" items={['macOS', 'Linux', 'Windows']}>
|
||||
<Tab value="macOS">
|
||||
```bash
|
||||
brew install unixodbc
|
||||
```
|
||||
</Tab>
|
||||
<Tab value="Linux">
|
||||
```bash
|
||||
sudo apt-get install -y libwebkit2gtk-4.1-dev libgtk-3-dev libappindicator3-dev librsvg2-dev patchelf libssl-dev unixodbc-dev
|
||||
```
|
||||
</Tab>
|
||||
<Tab value="Windows">
|
||||
无需额外安装(ODBC 已内置于 Windows)。
|
||||
</Tab>
|
||||
</Tabs>
|
||||
|
||||
### 运行
|
||||
|
||||
|
||||
Reference in new issue
Block a user