Tự host LimeSurvey CE trong Docker: MariaDB, persistent data và cổng 8080

LimeSurvey CE là nền tảng khảo sát mã nguồn mở. Tutorial i12bretro chạy MariaDB và LimeSurvey trong một Docker network, lưu survey upload ra host và mở trang quản trị ở cổng 8080. Tôi giữ đủ 5 bước hành động của trang số, nhưng thay mọi password mẫu bằng [REDACTED] trước khi đưa vào repo.¹

Video gốc đã được kiểm tra title/author qua YouTube oEmbed; tôi giữ player gốc, không tải lại hay rehost video.²

1. Cài Docker trên Linux host

Bước 1/5: Đăng nhập Linux host và chạy nguyên chuỗi cài Docker trong terminal:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14

# install prerequisites
sudo apt install apt-transport-https ca-certificates curl software-properties-common gnupg-agent -y
# add docker gpg key
curl -fsSL https://download.docker.com/linux/$(awk -F'=' '/^ID=/{ print $NF }' /etc/os-release)/gpg | sudo apt-key add -
# add docker software repository
sudo add-apt-repository "deb [arch=$(dpkg --print-architecture)] https://download.docker.com/linux/$(awk -F'=' '/^ID=/{ print $NF }' /etc/os-release) $(lsb_release -cs) stable"
# install docker
sudo apt install docker-ce docker-compose containerd.io -y
# enable and start docker service
sudo systemctl enable docker && sudo systemctl start docker
# add the current user to the docker group
sudo usermod -aG docker $USER
# reauthenticate for the new group membership to take effect
su - $USER

Tôi không chạy block này với quyền root tùy tiện ngoài các lệnh sudo; sau khi su - $USER, kiểm tra Docker CLI đã nhận group mới.

2. Chạy MariaDB và LimeSurvey

Bước 2/5: Tiếp tục trong terminal. Tạo thư mục, network và hai container theo flow của nguồn. Password phải là secret local mới; không dùng lại chuỗi trong source:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12

# create working directories
mkdir ~/docker/limesurvey -p && mkdir ~/docker/mariadb -p
# set owner of docker directory
sudo chown "$USER":"$USER" ~/docker -R
# allow the container to write to working directories
sudo chmod a+rwx -R ~/docker/limesurvey
# create containers network
docker network create containers
# run the mariadb docker container
docker run -d --name mariadb --network containers -e MYSQL_ROOT_PASSWORD='[REDACTED]' -e MYSQL_USER=limesurvey_rw -e MYSQL_PASSWORD='[REDACTED]' -e MYSQL_DATABASE=limesurvey -v ~/docker/mariadb:/var/lib/mysql -p 3306:3306 --restart=unless-stopped mariadb:latest
# run the limesurvey container
docker run -d --name limesurvey --network containers -e DB_TYPE=mysql -e DB_HOST=mariadb -e DB_PORT=3306 -e DB_USERNAME=limesurvey_rw -e DB_PASSWORD='[REDACTED]' -e DB_NAME=limesurvey -e DB_TABLE_PREFIX=" " -e ADMIN_USER=admin -e ADMIN_NAME=administrator -e ADMIN_EMAIL=admin@change.me -e ADMIN_PASSWORD='[REDACTED]' -v ~/docker/limesurvey:/var/www/html/upload/surveys -p 8080:8080 --restart=unless-stopped martialblog/limesurvey

Nguồn dùng chmod a+rwx để container ghi được; trên máy public tôi sẽ siết permission của thư mục và không expose cổng database 3306 ra Internet. Volume MariaDB và survey upload phải được backup riêng.

3. Mở trang quản trị

Bước 3/5: Mở trình duyệt và đi tới đúng path:

1

http://DNSorIP:8080/index.php/admin/

Thay DNSorIP bằng DNS/IP của Docker host, không thay phần /index.php/admin/ nếu muốn đi đúng trang quản trị.

Bước 4/5: Đăng nhập bằng thông tin admin đã đặt trong biến môi trường khi tạo container. Không ghi password thật vào lịch sử shell hoặc Markdown.

Bước 5/5: Sau khi đăng nhập, LimeSurvey hiển thị trang chào mừng. Từ đây tôi đổi password, kiểm tra volume upload và tạo một survey thử trước khi dùng production.

4. Kiểm tra sau khi triển khai

1
2
3

docker ps
docker logs mariadb
docker logs limesurvey

Nếu container LimeSurvey không kết nối được MariaDB, kiểm tra cả hai cùng ở network containers, DB_HOST=mariadb, user/database và password. Nguồn cũng liên kết Docker Hub martialblog/limesurvey và repository martialblog/docker-limesurvey; nên đọc tag/image hiện tại trước khi update thay vì khóa mù quáng vào latest.¹

Kết luận

Quy trình 5 bước đủ để dựng LimeSurvey CE trong HomeLab: cài Docker, tạo MariaDB và app, mở URL admin, login rồi kiểm tra welcome page. Phần cần làm nghiêm túc ngoài tutorial là secret, backup volume và reverse proxy/authentication nếu đưa dịch vụ ra ngoài LAN.

Nguồn