Casdoor 部署：從安裝到運行的操作紀錄

image

image

https://casdoor.org/docs/basic/server-installation/

1. 前言

Casdoor 是一款強大的 SSO（單一登入）身份認證系統，支援 OAuth 2.0 和 OpenID Connect，適用於多種應用場景。本篇文章將詳細介紹如何在本地或伺服器上部署 Casdoor，並進行基本配置。

2. 環境需求

在開始部署 Casdoor 之前，請確保您的系統滿足以下條件：

作業系統

  • Windows、Linux 或 macOS（均受支援）

必要軟體

  • **Go 1.17+**（後端語言）
  • **Node.js LTS (18)**（前端框架）
  • Yarn 1.x（推薦使用 Yarn 來管理前端依賴，避免 UI 樣式問題）

:::info
如果您的網路無法正常同步 Go 依賴包，建議使用 https://goproxy.cn/ 作為 Go 代理。
:::

資料庫支援

Casdoor 使用 XORM 作為 ORM，支援以下數據庫：

  • MySQL
  • MariaDB
  • PostgreSQL
  • CockroachDB
  • SQL Server
  • Oracle
  • SQLite 3
  • TiDB

3. 下載 Casdoor 原始碼

Casdoor 的原始碼托管於 GitHub，您可以使用 git 指令下載：

1
2
cd path/to/folder
git clone https://github.com/casdoor/casdoor

下載後，您將獲得包含前端（React）和後端（Go）的完整代碼庫。

4. 配置數據庫

根據您選擇的數據庫，修改 conf/app.conf 文件。

MySQL 配置

1
2
3
driverName = mysql
dataSourceName = root:123456@tcp(localhost:3306)/
dbName = casdoor

:::info
請確保 MySQL 數據庫已手動創建，名稱為 casdoor。
:::

PostgreSQL 配置

1
2
3
driverName = postgres
dataSourceName = "user=postgres password=postgres host=localhost port=5432 sslmode=disable dbname=casdoor"
dbName = casdoor

SQLite3 配置

1
2
3
driverName = sqlite
dataSourceName = "file:casdoor.db?cache=shared"
dbName = casdoor

5. 啟動 Casdoor

Casdoor 提供兩種運行模式：開發模式 和 生產模式。

開發模式

  1. 啟動後端（Go）
1
go run main.go

image

成功啟動後端的畫面

  1. 啟動前端（React）
1
2
3
cd web
yarn install
yarn start

image

  1. 訪問 Casdoor 後台

開啟瀏覽器，訪問 http://localhost:7001，使用預設管理員帳號登入：

  • 帳號： admin
  • 密碼： 123

這邊是成功登入的畫面

image

http://localhost:7001/

生產模式

  1. 編譯後端
1
2
go build
./casdoor
  1. 編譯前端
1
2
3
cd web
yarn install
yarn build
  1. 訪問 Casdoor

瀏覽器打開 http://localhost:8000，使用管理員帳號登入。

  • 帳號： admin
  • 密碼： 123

6. Casdoor 端口設定

根據不同環境，請確保使用正確的端口：

  • 開發模式： http://localhost:7001
  • 生產模式： http://localhost:8000

若有需求變更端口，請修改 conf/app.conf 中的 httpport 參數。

7. 結語

至此，您已成功部署 Casdoor，並完成基本的配置與運行。如果您希望進一步整合到您的應用中，可以參考官方文檔進行 API 調用、OAuth 配置等。