雷池 docker env 配置說明

学安全的张同学發表於2024-11-19
Docker

雷池 docker env 配置說明

當透過安裝命令bash -c "$(curl -fsSLk https://waf-ce.chaitin.cn/release/latest/setup.sh)"安裝完雷池之後，在安裝目錄下面會生成一個 .env 檔案，該檔案是雷池的安裝配置，樣例如下

SAFELINE_DIR=/data/safeline
IMAGE_TAG=latest
MGT_PORT=9443
POSTGRES_PASSWORD=qazxswedc
SUBNET_PREFIX=172.22.222
ARCH_SUFFIX=-arm
IMAGE_PREFIX=swr.cn-east-3.myhuaweicloud.com/chaitin-safeline
RELEASE=-lts

SAFELINE_DIR

該配置是雷池的資料持久化目錄，即雷池所有的資料都會儲存在該目錄下

如果想要遷移資料到本機的其他路徑，可以執行如下命令

# 以 /data/safeline 遷移到 /data/new_safeline 為例子
cd /data/safeline
docker compose down
sed -i 's#SAFELINE_DIR=.*#SAFELINE_DIR=/data/new_safeline#' .env
mv /data/safeline /data/new_safeline
cd /data/new_safeline
docker compose up -d

IMAGE_TAG

該配置表示安裝的雷池版本，如需指定安裝版本，可以執行以下命令

由於新版本存在資料庫資料遷移或者新功能的引入導致資料庫儲存的資料格式改變，故降級為舊版本的時候可能會導致程式碼和資料庫表不匹配而導致服務無法正常啟動

# 以安裝目錄為 /data/safeline，指定修改版本為 7.2.3 為例
cd /data/safeline
sed -i 's#IMAGE_TAG=.*#IMAGE_TAG=7.2.3#' .env
docker compose up -d

MGT_PORT

該配置為雷池管理端對外暴露的埠，可以修改為任意空閒的埠

# 以安裝目錄為 /data/safeline，指定修改埠為 8888 為例
cd /data/safeline
sed -i 's#MGT_PORT=.*#MGT_PORT=8888#' .env
docker compose up -d

POSTGRES_PASSWORD

該配置為資料庫的密碼，賬號預設為safeline-ce

在安裝完雷池之後如果想要修改密碼可以執行以下命令

由於資料庫密碼是拼接到 URL 裡面的，注意不要有特殊字元

# 以安裝目錄為 /data/safeline，指定資料庫密碼為 123456 為例
cd /data/safeline
sed -i 's#POSTGRES_PASSWORD=.*#POSTGRES_PASSWORD=123456#' .env
docker exec -i safeline-pg psql -U safeline-ce -c "ALTER USER \"safeline-ce\" WITH PASSWORD '123456';"
docker compose up -d

SUBNET_PREFIX

該配置是雷池容器的 IP 網段，如果網段衝突，會導致網橋無法正常建立或者容器網路無法正常通訊

如果想修改為其他的空閒網段，可以執行如下命令

# 以安裝目錄為 /data/safeline，指定網段為 169.254.0.1/24 為例
cd /data/safeline
docker compose down
sed -i 's#SUBNET_PREFIX=.*#SUBNET_PREFIX=169.254.0#' .env
docker compose up -d

ARCH_SUFFIX

該配置表示是否使用的是 arm 架構的映象，如果為 arm 架構的映象則為ARCH_SUFFIX=-arm

IMAGE_PREFIX

該配置是雷池映象的映象源，目前指令碼支援 docker 和 華為雲

映象源 配置
docker chaitin
華為雲 swr.cn-east-3.myhuaweicloud.com/chaitin-safeline

如果想要修改映象源，可以執行以下命令

# 以安裝目錄為 /data/safeline，指定映象源為 docker 為例
cd /data/safeline
sed -i 's#IMAGE_PREFIX=.*#IMAGE_PREFIX=chaitin#' .env
docker compose up -

RELEASE

該配置表示當前版本是否為lts版本，如果為 lts 版本則為RELEASE=-lts

相關文章