前往小程序,Get更优阅读体验!
立即前往
首页
学习
活动
专区
工具
TVP
发布
社区首页 >专栏 >Casdoor 开始

Casdoor 开始

作者头像
GoCoding
发布2023-08-26 14:58:43
5270
发布2023-08-26 14:58:43
举报
文章被收录于专栏:GoCoding

Casdoor 是一个基于 OAuth 2.0 / OIDC 的中心化的单点登录(SSO)身份验证平台,简单来说,就是 Casdoor 可以帮你解决用户管理的难题,你无需开发用户登录、注册等与用户鉴权相关的一系列功能,只需几个步骤进行简单配置,与你的主应用配合,便可完全托管你的用户模块,简单省心,功能强大。

  • 官网: https://casdoor.org/
  • 代码: https://github.com/casdoor/casdoor

官网有 demo 体验,及文档。本文是依照文档「服务器安装」[1]「使用 Docker 运行」[2]于 Ubuntu 22 上的实践记录。

安装环境

  • Go 1.17+[3]
  • Node.js LTS (16或14)[4]
  • Yarn 1.x[5]

安装 Go

代码语言:javascript
复制
# 下载,依据系统选择 Linux x86-64 的发布包
curl -O -L https://go.dev/dl/go1.20.4.linux-amd64.tar.gz
# 解压
tar -xzvf go1.20.4.linux-amd64.tar.gz
# 重命名,带上版本号
mv go go1.20.4.linux-amd64
# 软链,便于配置或切版本
sudo ln -sfT `pwd`/go1.20.4.linux-amd64 /usr/local/go
# 配置,GOPATH 用自己的工作目录
cat <<-EOF >> ~/.bashrc
# go
export GOROOT=/usr/local/go
export GOPATH=\$HOME/Codes/Go
export PATH=\$GOROOT/bin:\$GOPATH/bin:\$PATH
EOF
# 检查
go version
go env

安装 Node.js

代码语言:javascript
复制
# 下载,选了当前最新的 LTS 版本,可用
curl -O -L https://nodejs.org/dist/v18.16.0/node-v18.16.0-linux-x64.tar.xz
# 解压
tar -xvf node-v18.16.0-linux-x64.tar.xz
# 软链,便于配置或切版本
sudo ln -sfT `pwd`/node-v18.16.0-linux-x64 /usr/local/node
# 配置,GOPATH 用自己的工作目录
cat <<-EOF >> ~/.bashrc
# node
export NODE_HOME=/usr/local/node
export PATH=\$NODE_HOME/bin:\$PATH
EOF
# 检查
node -v
npm -v

安装 Yarn

代码语言:javascript
复制
npm install yarn -g
# 检查
yarn -v

安装 MySQL

代码语言:javascript
复制
sudo apt update -y
# 安装
sudo apt install mysql-server -y

# 检查
systemctl status mysql.service
# 或启动
systemctl start mysql.service

配置 MySQL:

1 修改 root 用户的密码,

代码语言:javascript
复制
sudo mysql
ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY 'YourPassword';
exit

不然,执行 mysql_secure_installation 会遇到如下错误:

代码语言:javascript
复制
 ... Failed! Error: SET PASSWORD has no significance for user 'root'@'localhost' as the authentication method used doesn't store authentication data in the MySQL server. Please consider using ALTER USER instead if you want to change authentication parameters.

2 执行配置脚本 mysql_secure_installation 把不安全的功能都给关了,

代码语言:javascript
复制
$ sudo mysql_secure_installation

Securing the MySQL server deployment.

Enter password for user root:
The 'validate_password' component is installed on the server.
The subsequent steps will run with the existing configuration
of the component.
Using existing password for root.

Estimated strength of the password: 100
Change the password for root ? ((Press y|Y for Yes, any other key for No) : n

 ... skipping.
By default, a MySQL installation has an anonymous user,
allowing anyone to log into MySQL without having to have
a user account created for them. This is intended only for
testing, and to make the installation go a bit smoother.
You should remove them before moving into a production
environment.

Remove anonymous users? (Press y|Y for Yes, any other key for No) : y
Success.


Normally, root should only be allowed to connect from
'localhost'. This ensures that someone cannot guess at
the root password from the network.

Disallow root login remotely? (Press y|Y for Yes, any other key for No) : y
Success.

By default, MySQL comes with a database named 'test' that
anyone can access. This is also intended only for testing,
and should be removed before moving into a production
environment.


Remove test database and access to it? (Press y|Y for Yes, any other key for No) : y
 - Dropping test database...
Success.

 - Removing privileges on test database...
Success.

Reloading the privilege tables will ensure that all changes
made so far will take effect immediately.

Reload privilege tables now? (Press y|Y for Yes, any other key for No) : y
Success.

All done!

3 恢复 sudo mysql 登录,

用客户端的话,跳过这一步。

代码语言:javascript
复制
# 密码登录
mysql -u root -p
# 恢复 sudo mysql 登录
ALTER USER 'root'@'localhost' IDENTIFIED WITH auth_socket;
# 退出
exit

安装 MySQL 客户端:

代码语言:javascript
复制
# 例如,用 MySQL Workbench
sudo snap install mysql-workbench-community
# 或者,用 phpMyAdmin 等

选择 Local 实例,用密码登录,

创建一个名为 casdoor 的数据库,

另外,可创建一个名为 casdoor 的新用户,专门管理该数据库。

获取源码

进工作目录,获取 Casdoor 源码,

代码语言:javascript
复制
# 获取源码
git clone --depth 1 https://github.com/casdoor/casdoor.git

配置

配置位于 casdoor/conf/app.conf

代码语言:javascript
复制
appname = casdoor
httpport = 8000
runmode = dev
copyrequestbody = true
driverName = mysql
dataSourceName = root:123456@tcp(localhost:3306)/
dbName = casdoor
tableNamePrefix =
showSql = false
redisEndpoint =
defaultStorageProvider =
isCloudIntranet = false
authState = "casdoor"
socks5Proxy = "127.0.0.1:10808"
verificationCodeTimeout = 10
initScore = 2000
logPostOnly = true
origin =
staticBaseUrl = "https://cdn.casbin.org"
isDemoMode = false
batchSize = 100
ldapServerPort = 389
languages = en,zh,es,fr,de,id,ja,ko,ru,vi
quota = {"organization": -1, "user": -1, "application": -1, "provider": -1}

目前先只配置数据库字段 driverName dataSourceName dbName。更多字段说明,见官方文档「服务器安装 / 通过-ini-文件配置」。

运行

开发模式

运行后端:

代码语言:javascript
复制
cd casdoor/
go run main.go

如果发生错误 checksum mismatch,可执行:

代码语言:javascript
复制
go clean -modcache
rm go.sum
go mod tidy
# 还不行,切个代理,再试一次
#  可能代理缓存不一致;可写进 ~/.bashrc
export GOPROXY="https://goproxy.cn,direct"

运行前端:

代码语言:javascript
复制
cd casdoor/web
yarn install
yarn start

访问 http://localhost:7001/,用户 admin 密码 123 登录,

生产模式

运行后端:

代码语言:javascript
复制
cd casdoor/
go build
./casdoor

运行前端:

代码语言:javascript
复制
cd casdoor/web
yarn install
yarn build

容器运行

Docker 准备

Install Docker Desktop on Ubuntu[6]

代码语言:javascript
复制
$ docker -v
Docker version 23.0.6, build ef23cbc

$ docker compose version
Docker Compose version v2.17.3

Docker 运行

Casdoor 可以使用 docker-compose 运行,它带有独立的数据库,

代码语言:javascript
复制
cd casdoor/
docker compose up

可以如下修改,用本地已有的数据库,

  • 编辑 docker-compose.yml
    • 删掉 services/casdoor 下,
      • entrypoint 里的 --createDatabase=true 参数
      • depends_on 里的 db 依赖
    • 删掉 services/db 的所有配置
代码语言:javascript
复制
version: '3.1'
services:
  casdoor:
    restart: always
    build:
      context: ./
      dockerfile: Dockerfile
      target: STANDARD
    entrypoint: /bin/sh -c './server'
    ports:
      - "8000:8000"
    volumes:
      - ./conf:/conf/
  • 编辑 Dockerfile 删掉 ENTRYPOINT ["/server"] 之后的 db 内容
    • 遇到 go build 提示版本问题,可修改 FROM golang:1.17.5 AS BACK 升下版本,如 1.20.4
    • 遇到 go test 不过,
      • 若下载问题,可命令前加 export GOPROXY="https://goproxy.cn,direct" && 用代理
      • TestGetVersionInfo Fail,可 git pull --unshallow 拉取更多 commits 即可
    • 遇到 apk 安装问题,可以注掉 RUN sed -i 's/https/http/' /etc/apk/repositories
    • 遇到 yarn fresh packages 永不终止,可以注掉 yarn config set registry https://registry.npmmirror.com

此外,再写个独立的 docker-secret.yaml 来放 services/casdoor 的数据库配置:

代码语言:javascript
复制
version: '3.1'
services:
  casdoor:
    environment:
      driverName: "mysql"
      dataSourceName: "casdoor:password@tcp(host.docker.internal:3306)/"
      dbName: "casdoor"

最后,

代码语言:javascript
复制
# 运行服务
$ docker compose -f docker-compose.yml -f docker-secret.yml up
[+] Running 2/0
 ✔ Network casdoor_default      Created                                                                                                 0.0s
 ✔ Container casdoor-casdoor-1  Created                                                                                                 0.0s
Attaching to casdoor-casdoor-1
casdoor-casdoor-1  | 2023/05/14 06:00:00 Listening on 0.0.0.0:389
casdoor-casdoor-1  | 2023/05/14 06:00:00.000 [I]  http server Running on http://:8000

访问 http://localhost:8000/,用户 admin 密码 123 登录。

结语

Casdoor 这里选择源码方式安装,是考虑做定制化修改;使用容器编译和运行,是考虑发布和部署。

至于 Casdoor 功能如何、怎么使用,要阅读官方文档多做了解,同时也在运行环境里实际玩上一玩。

脚注

[1]

「服务器安装」: https://casdoor.org/zh/docs/basic/server-installation

[2]

「使用 Docker 运行」: https://casdoor.org/zh/docs/basic/try-with-docker

[3]

Go 1.17+: https://go.dev/dl/

[4]

Node.js LTS (16或14): https://nodejs.org/

[5]

Yarn 1.x: https://classic.yarnpkg.com/en/docs/install

[6]

Install Docker Desktop on Ubuntu: https://docs.docker.com/desktop/install/ubuntu/

本文参与 腾讯云自媒体同步曝光计划,分享自微信公众号。
原始发表:2023-05-14,如有侵权请联系 cloudcommunity@tencent.com 删除

本文分享自 GoCoding 微信公众号,前往查看

如有侵权,请联系 cloudcommunity@tencent.com 删除。

本文参与 腾讯云自媒体同步曝光计划  ,欢迎热爱写作的你一起参与!

评论
登录后参与评论
0 条评论
热度
最新
推荐阅读
目录
  • 安装环境
    • 安装 Go
      • 安装 Node.js
        • 安装 Yarn
          • 安装 MySQL
          • 获取源码
          • 配置
          • 运行
            • 开发模式
              • 生产模式
              • 容器运行
                • Docker 准备
                  • Docker 运行
                  • 结语
                    • 脚注
                    相关产品与服务
                    数据库
                    云数据库为企业提供了完善的关系型数据库、非关系型数据库、分析型数据库和数据库生态工具。您可以通过产品选择和组合搭建,轻松实现高可靠、高可用性、高性能等数据库需求。云数据库服务也可大幅减少您的运维工作量,更专注于业务发展,让企业一站式享受数据上云及分布式架构的技术红利!
                    领券
                    问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档