ISPConfig 3 Roundcube Plugin trên Debian 9 (Stretch)

[theanh]

• Phiên bản hệ điều hành: Debian 9.4 và 9.5 Stretch
• Phiên bản Roundcube: 1.2.3+dfsg.1-4+deb9u1 và u2
• Phiên bản ISPConfig 3: 3.1.11 và 3.1.13

Hướng dẫn này dựa trên Hướng dẫn cài đặt ISPConfig3_roundcube từ Hướng dẫn.

Điều kiện tiên quyết​

Sử dụng phiên bản Roundcube đi kèm với Debian 9, cài đặt theo hướng dẫn trong Hướng dẫn máy chủ hoàn hảo cho Debian Stretch.

Sử dụng ISPConfig hiện tại, phiên bản mới nhất hiện tại là 3.1.13.

Thêm Người dùng từ xa ISPConfig​

Thêm người dùng từ xa ISPConfig để sử dụng Roundcube. Chọn một tên phù hợp, tôi sử dụng rcmail-remote. Chọn một mật khẩu tốt, tôi thường tạo mật khẩu bằng apg, trước tiên hãy thực hiện apt-get install apg.

apg -m 12 -l M NCL

Tạo người dùng từ xa trong Bảng điều khiển ISPConfig, tab Hệ thống, bên dưới Quản lý người dùng là "Người dùng từ xa". Nhấp vào nút "Thêm người dùng mới".

Tôi không tích vào Truy cập từ xa:, thiết lập của tôi có máy chủ email riêng biệt nơi các tệp email và Roundcube và Dovecot được cài đặt. Vì vậy, mặc dù đây là "người dùng từ xa" nhưng không cần truy cập từ xa trong trường hợp của tôi.

Đối với người dùng này, hãy chọn:

- Chức năng máy chủ- Chức năng máy khách- Chức năng người dùng email- Chức năng bí danh email- Chức năng người dùng bộ lọc thư rác email- Chức năng chính sách bộ lọc thư rác email- Chức năng lấy thư email- Chức năng danh sách trắng bộ lọc thư rác email- Chức năng danh sách đen bộ lọc thư rác email- Chức năng bộ lọc người dùng email

Danh sách đó theo thứ tự các mục xuất hiện trong Bảng điều khiển ISPConfig.

Cài đặt Plugin ISPConfig RoundCube​

Lấy ISPConfig3-plugins từ Github. Tôi đã sử dụng phiên bản mới nhất cho RoundCube 1.2.3. Tác giả plugin viết trong hướng dẫn sử dụng để kiểm tra từ Subversion trực tiếp đến thư mục gốc RoundCube. Tôi thích kiểm tra ở nơi khác, vì vậy tôi không làm hỏng thư mục hệ thống nơi apt-get cài đặt các tệp.

Readme.Debian trong /usr/share/doc/roundcube khuyên "Thêm plugin của bạn vào /var/lib/roundcube/plugins.". Tôi kiểm tra từ svn đến /root/ISPConfig3_plugins và sao chép từ đó đến /var/lib/roundcube/plugins. Các plugin từ các gói Debian được cài đặt trong /usr/share/roundcube và có một liên kết tượng trưng đến các plugin từ /var/lib/roundcube/plugins. Cài đặt Subversion để nhận lệnh svn. (apt-get install subversion).

cd /root
mkdir ISPConfig3_plugins
cd ISPConfig3_plugins
svn co https://github.com/w2c/ispconfig3_roundcube/trunk/ .

cd ispconfig3_account/config
cp config.inc.php.dist config.inc.php

Cấu hình Plugin​

Chỉnh sửa tệp đã sao chép ở lệnh cuối cùng của các dòng lệnh trước đó. Điền thông tin người dùng từ xa đã tạo ở Bước 2.

cd /root/ISPConfig3_plugins

editor ispconfig3_account/config/config.inc.php

Tệp gốc trông như thế này:

Thay đổi remote_soap_user, remote_soap_pass (người dùng và mật khẩu đã tạo ở Bước 2) và soap_url. Nếu bạn sử dụng bảng điều khiển ISPConfig với https://, hãy sử dụng cùng một bảng điều khiển ở đây cho soap_url. Bạn có thể sử dụng địa chỉ IP hoặc tên máy chủ và tên miền trong soap_url. Số cổng giống như đối với bảng điều khiển ISPConfig.

Kích hoạt Plugin​

Chỉnh sửa cấu hình Roundcube, trong tệp /etc/roundcube/config.inc.php. Tìm kiếm "Danh sách các plugin đang hoạt động". Theo mặc định, Debian Stretch không bật bất kỳ plugin nào, vì vậy danh sách sẽ trống trừ khi bạn đã bật một số plugin. Nếu danh sách trống, tức là trông như thế này:

// Danh sách các plugin đang hoạt động (trong thư mục plugins/)// Debian: cài đặt roundcube-plugins trước để có bất kỳ$config['plugins'] = array();

chỉ cần thay thế bằng:

$config['plugins'] = array("jqueryui","ispconfig3_account", "ispconfig3_autoreply","ispconfig3_autoselect", "ispconfig3_pass", "ispconfig3_spam","ispconfig3_fetchmail", "ispconfig3_filter","ispconfig3_forward", "ispconfig3_wblist");

Thứ tự của các plugin rất quan trọng! Không thay đổi thứ tự trừ khi bạn biết mình đang làm gì.

Nếu không trống, hãy thêm các plugin ISPConfig3 sau các plugin hiện có. Nếu một số plugin không cần thiết, hãy xóa plugin đó khỏi danh sách và plugin đó sẽ không còn được bật nữa.

Nếu bạn chỉ sử dụng một máy chủ thư, hãy xóa plugin ispconfig3_autoselect vì trong trường hợp đó, bạn không cần plugin này và nó chỉ gây ra vấn đề nếu bạn không cấu hình đúng cách.

Tôi đã xóa ispconfig3_forward vì tôi nhận thấy lỗi trong /var/log/roundcube/errors cho dòng 135 trong tệp ispconfig3_forward/ispconfig3_forward.php.

Sao chép Plugin vào vị trí hệ thống​

Bây giờ bạn phải sao chép các plugin từ thư mục checkout vào /var/lib/roundcube. Ví dụ, hãy làm như sau:

cd /root/ISPConfig3_plugins
for f in ispconfig3_* ; do echo $f ; cp --recursive $f /var/lib/roundcube/plugins/ ; done

Đang kiểm tra​

Nếu các Plugin mới được hiển thị trong Cài đặt, nhưng khi nhấp vào chúng, thông báo lỗi "Soap Error: Not Found" hoặc "Soap Error: Bad Request" sẽ bật lên, hãy kiểm tra cài đặt soap_url. Có thể thiếu ký tự gạch chéo "/" ở cuối.

Kiểm tra và tận hưởng. Có một mục thứ 5 trong menu Cài đặt do các plugin này tạo ra.



Nếu bạn gặp lỗi, hãy đọc Câu hỏi thường gặp về xử lý sự cố của tác giả plugin ISPConfig3 từ https://github.com/w2c/ispconfig3_roundcube/wiki/Troubleshooting---FAQ. Nếu điều đó không giúp ích, hãy đọc nhật ký từ /var/log/roundcube/errors. Nếu bạn vẫn gặp sự cố, hãy xem các nhật ký khác trong các thư mục /var/log và /var/log/apache2. Nếu không có cách nào giúp ích, hãy kiểm tra xem bạn đã cài đặt máy chủ theo Hướng dẫn về máy chủ hoàn hảo chưa. Tôi đã được thông báo rằng hình ảnh VM không có php-soap được cài đặt và ISPConfig được cài đặt theo tập lệnh cũng thiếu gói PHP này.