offlineimap - Trực tuyến trên đám mây

CHƯƠNG TRÌNH:

TÊN

offlineimap - Đồng bộ hóa hộp thư và Trình gửi thư

SYNOPSIS

bản đồ ngoại tuyến (Tùy chọn)

MÔ TẢ

Đồng bộ hóa các tài khoản được định cấu hình trong tệp cấu hình qua IMAP. Mỗi tài khoản có
hai bên.

Một bên phải là máy chủ IMAP. Bên kia có thể là một Maildir hoặc một bên khác
Máy chủ IMAP.

LỰA CHỌN

-h, - trợ giúp
Hiển thị tóm tắt các tùy chọn.

--phiên bản
Phiên bản đầu ra.

- chạy thử
Chạy ở chế độ chạy khô.

Không thực sự sửa đổi bất kỳ cửa hàng nào nhưng hãy kiểm tra và in những hành động đồng bộ hóa nào
sẽ được thực hiện nếu đồng bộ hóa được thực hiện. Nó sẽ không đưa ra chính xác
thông tin những gì sẽ xảy ra. Ví dụ: nếu chúng ta cần tạo một thư mục, nó chỉ xuất ra
sẽ tạo thư mục X, nhưng không phải là bao nhiêu và nó sẽ chuyển những thư nào.

--thông tin
Xuất thông tin về kho email đã định cấu hình.

Hữu ích cho việc gỡ lỗi và báo cáo lỗi. Sử dụng kết hợp với tùy chọn -a để giới hạn
đầu ra cho một tài khoản. Chế độ này sẽ ngăn không cho bất kỳ đồng bộ hóa thực tế nào xảy ra và
thoát sau khi hết thông tin gỡ lỗi.

-1
Hạn chế các hoạt động đa luồng và chỉ chạy đồng bộ một luồng.

Điều này đặt hiệu quả các tài khoản maxsyncaccount và tất cả tệp cấu hình maxconnections
biến thành 1. Đây là 1, số.

-P
Đặt OfflineIMAP thành chế độ cấu hình.

Chương trình sẽ tạo DIR (nó phải chưa tồn tại). Khi nó chạy, lập hồ sơ Python
thông tin về mỗi chủ đề được đăng nhập vào profiledir. Xin lưu ý: Tùy chọn này là
hiện chỉ để gỡ lỗi và tối ưu hóa, và KHÔNG được sử dụng trừ khi bạn có
lý do cụ thể để làm như vậy. Nó sẽ làm giảm đáng kể hiệu suất chương trình, có thể
giảm độ tin cậy và có thể tạo ra một lượng lớn dữ liệu. Tùy chọn này ngụ ý -1
tùy chọn.

-Một
Ghi đè phần tài khoản trong tệp cấu hình.

Cho phép một người chỉ định một tài khoản cụ thể hoặc một tập hợp các tài khoản để đồng bộ hóa mà không cần
để chỉnh sửa tệp cấu hình.

-NS
Chỉ định một tệp cấu hình để sử dụng.

-NS
Bật gỡ lỗi cho OfflineIMAP.

Điều này rất hữu ích nếu bạn muốn theo dõi sự cố hoặc tìm ra những gì đang xảy ra
dưới mui xe. Tùy chọn này yêu cầu một hoặc nhiều kiểu gỡ lỗi, được phân tách bằng dấu phẩy.
Chúng xác định chính xác những gì sẽ được gỡ lỗi và cho đến nay bao gồm hai tùy chọn: imap,
chủ đề, maildir hoặc TẤT CẢ. Tùy chọn imap sẽ cho phép phân tích và phân tích luồng giao thức IMAP
gỡ lỗi. Lưu ý rằng đầu ra có thể chứa mật khẩu, vì vậy hãy cẩn thận để loại bỏ
từ đầu ra gỡ lỗi trước khi gửi nó cho bất kỳ ai khác. Tùy chọn maildir sẽ
cho phép gỡ lỗi cho các hoạt động Maildir nhất định. Việc sử dụng bất kỳ tùy chọn gỡ lỗi nào (trừ khi
Chủ đề được bao gồm), ngụ ý tùy chọn luồng đơn -1.

-l
Gửi nhật ký đến .

-s
Gửi nhật ký đến nhật ký hệ thống.

-NS
Chỉ đồng bộ hóa các thư mục được chỉ định.

Tên thư mục là tên thư mục chưa được dịch của kho lưu trữ từ xa. Cái này
tùy chọn dòng lệnh ghi đè bất kỳ bộ lọc thư mục và gấp lại bao gồm các tùy chọn trong
tập tin cấu hình.

-k <[section:] option = value
Ghi đè bất kỳ tùy chọn tệp cấu hình nào.

Nếu "section" bị bỏ qua, nó sẽ được mặc định là "general". Bất kỳ dấu gạch dưới nào trong tên phần
được thay thế bằng dấu cách: ví dụ: để ghi đè tùy chọn "tự động làm mới" trong
Phần "[Tài khoản Cá nhân]" trong tệp cấu hình mà người ta sẽ sử dụng "-k
Account_Personal: autorefresh = 30 ". Lặp lại tùy chọn này nếu cần để xác định lại
nhiều lựa chọn.

-o
Chỉ chạy một lần.

Bỏ qua mọi cài đặt tự động làm mới trong tệp cấu hình.

-q
Chỉ chạy đồng bộ hóa nhanh.

Bỏ qua mọi cập nhật cờ trên máy chủ IMAP. Nếu cờ trên IMAP từ xa thay đổi, và chúng tôi
có tin nhắn cục bộ, nó sẽ được giữ nguyên trong thời gian nhanh chóng. Tùy chọn này là
bị bỏ qua nếu tối đa được đặt.

-u
Chỉ định một giao diện người dùng thay thế để sử dụng.

Điều này ghi đè mặc định được chỉ định trong tệp cấu hình. Giao diện người dùng được chỉ định với
-u sẽ bị buộc phải được sử dụng, ngay cả khi kiểm tra xác định rằng nó không thể sử dụng được. Khả thi
các lựa chọn giao diện là: yên tĩnh, cơ bản, nhật ký hệ thống, ttyui, đèn nháy, machineui.

--cột [= ], - không có cột
Hiển thị danh sách chi nhánh trong các cột. Xem biến cấu hình column.branch để biết tùy chọn
cú pháp .-- cột và - không cột không có tùy chọn tương đương với luôn luôn và không bao giờ
tương ứng.

Tùy chọn này chỉ có thể áp dụng trong chế độ không dài dòng.

TỔNG HỢP THI

Theo mặc định, chúng tôi sử dụng các cài đặt khá thận trọng, an toàn để đồng bộ hóa nhưng điều đó có thể
không phải là một trong những hoạt động tốt nhất. Khi bạn đã thiết lập và chạy mọi thứ, bạn có thể muốn
để xem xét việc tăng tốc độ đồng bộ hóa của bạn. Dưới đây là một số gợi ý và mẹo về cách
để đạt được điều này.

1. Sử dụng các kết nối tối đa> 1.

Theo mặc định, chúng tôi chỉ sử dụng một kết nối với máy chủ IMAP. Sử dụng 2 hoặc thậm chí 3 tốc độ
mọi thứ tăng lên đáng kể trong hầu hết các trường hợp. Cài đặt này đi vào [Kho lưu trữ XXX]
phần.

2. Sử dụng bộ lọc thư mục.

Đồng bộ nhanh nhất là đồng bộ có thể bỏ qua một số thư mục. Tôi sắp xếp hộp thư đến hàng tháng
và bỏ qua mọi thư mục cũ hơn 2-3 tháng, điều này chỉ cho phép tôi
kiểm tra một phần nhỏ Thư của tôi trên mỗi lần đồng bộ hóa. Nếu bạn chưa làm điều này, hãy làm nó :).
Xem phần bộ lọc thư mục, ví dụ offlineimap.conf.

3. Bộ nhớ đệm.

Bộ đệm trạng thái mặc định là một tệp văn bản thuần túy sẽ ghi ra tệp hoàn chỉnh
cho mỗi tin nhắn mới (hoặc thậm chí cờ đã thay đổi) vào một tệp tạm thời. Nếu bạn có
nhiều tệp trong một thư mục, đây là vài trăm kilo đến megabyte cho mỗi thư và
chắc chắn sẽ làm cho mọi thứ chậm hơn. Tôi khuyên bạn nên sử dụng phụ trợ sqlite cho điều đó. Nhìn thấy
cài đặt status_backend = sqlite trong ví dụ offlineimap.conf. Bạn sẽ cần đến
đã cài đặt python-sqlite để sử dụng. Điều này sẽ giúp bạn tiết kiệm nhiều đĩa
hoạt động. Xin lưu ý rằng chương trình phụ trợ sqlite vẫn được coi là thử nghiệm vì nó đã
chỉ mới được đưa vào gần đây (mặc dù mất bộ nhớ cache trạng thái của bạn không phải là
bi kịch vì tệp đó có thể được xây dựng lại tự động)

4. Sử dụng đồng bộ nhanh.

Đồng bộ hóa thông thường sẽ yêu cầu tất cả cờ và tất cả UID của tất cả các thư trong mỗi thư mục
mất khá nhiều thời gian. MỘT nhanh chóng đồng bộ hóa chỉ so sánh số lượng thư trong một thư mục
về phía IMAP (mặc dù nó sẽ phát hiện các thay đổi cờ ở phía Maildir của mọi thứ). MỘT
đồng bộ nhanh trên tài khoản nhỏ của tôi sẽ mất 7 giây thay vì 40 giây. Vd: tôi
chạy một tập lệnh cron thực hiện đồng bộ hóa thông thường mỗi ngày một lần và chỉ đồng bộ hóa nhanh (-q)
đồng bộ hóa "-f INBOX" ở giữa.

5. Tắt fsync.

Trong phần [chung] bạn có thể đặt fsync thành True hoặc False. Nếu bạn muốn chơi 110%
an toàn và đợi cho tất cả các hoạt động vào đĩa trước khi tiếp tục, bạn có thể đặt điều này
thành True. Nếu bạn đặt nó thành False, bạn sẽ mất một phần an toàn đó, giao dịch nó để lấy tốc độ.

NÂNG CẤP TỪ ĐỒNG BẰNG TEXT ĐẾN SQLITE CACHE FORMAT

OfflineImap sử dụng một bộ đệm để lưu trữ trạng thái mới nhất của thư (cờ, v.v.).

Trước đây, điều đó có nghĩa là các tệp văn bản thuần túy, nhưng gần đây chúng tôi đã giới thiệu dựa trên sqlite
bộ nhớ cache, giúp tăng hiệu suất và sử dụng CPU trên các thư mục lớn. Đây là cách nâng cấp
cài đặt bộ nhớ cache văn bản thuần túy hiện có sang sqlite dựa trên:

1. Đồng bộ hóa để đảm bảo mọi thứ tương tự nhau một cách hợp lý.

2. Thay đổi phần tài khoản thành "status_backend = sqlite".

3. Chạy đồng bộ hóa mới.

Điều này sẽ chuyển đổi bộ đệm văn bản thuần túy của bạn thành bộ đệm sqlite (nhưng hãy để nguyên
bộ nhớ cache văn bản xung quanh để dễ dàng hoàn nguyên). Việc này phải nhanh chóng và không liên quan đến bất kỳ thư nào
up / download.

4. Xem nếu nó hoạt động! :-)

5. Nếu nó không hoạt động, hãy quay lại phiên bản cũ hoặc đặt "status_backend = trơn"

6. Xóa các tập tin bộ đệm văn bản cũ.

Khi bạn chắc chắn rằng nó hoạt động, bạn có thể xóa ~ / .offlineimap / Account-foo / LocalStatus
thư mục (bộ đệm mới sẽ nằm trong thư mục LocalStatus-sqlite)

AN NINH VÀ SSL

Theo mặc định, OfflineIMAP sẽ kết nối bằng bất kỳ phương thức nào openssl hỗ trợ, đó là
SSLv2, SSLv3 hoặc TLSv1.

Xin lưu ý rằng SSLv2 nổi tiếng là không an toàn và không được dùng nữa. Thật không may, python2 không
đưa ra những cách dễ dàng để tắt SSLv2. Bạn nên kiểm tra thiết lập của mình và đảm bảo rằng
máy chủ thư không sử dụng kết nối SSLv2. Sử dụng ví dụ: "openssl s_client -host
mail.server -port 443 "để tìm kết nối được sử dụng theo mặc định.

· Kiểm tra chứng chỉ

Rất tiếc, theo mặc định, chúng tôi sẽ không xác minh chứng chỉ của máy chủ IMAP TLS / SSL
chúng tôi kết nối với, vì vậy kết nối bằng SSL không đảm bảo chống lại các cuộc tấn công trung gian.
Trong khi xác minh chứng chỉ máy chủ, bạn nên kiểm tra dấu vân tay. Có
hiện tại chỉ có một cách an toàn để đảm bảo rằng bạn kết nối với đúng máy chủ trong một
cách mã hóa: bạn có thể chỉ định một tập tin sslcacert cài đặt trong phần kho lưu trữ của bạn
của offlineimap.conf trỏ đến một tệp có chứa (trong số những người khác) Chứng chỉ CA
ở định dạng PEM xác thực chứng chỉ máy chủ của bạn. Trong trường hợp này, chúng tôi sẽ kiểm tra
rằng:

1. Chứng chỉ SSL của máy chủ được xác thực bởi Chứng chỉ CA.

2. Tên máy chủ lưu trữ khớp với chứng chỉ SSL.

3. Chứng chỉ máy chủ chưa quá ngày hết hạn.

Câu hỏi thường gặp có một mục về cách tạo chứng chỉ và chứng chỉ CA của riêng bạn.

· Bắt đầuTLS

Nếu bạn vẫn chưa định cấu hình tài khoản của mình để kết nối qua SSL, thì OfflineImap sẽ
vẫn cố gắng thiết lập kết nối SSL thông qua chức năng STARTTLS, trong trường hợp imap
máy chủ hỗ trợ nó.

Không có chứng chỉ hoặc kiểm tra vân tay nào liên quan, khi sử dụng STARTTLS
(thư viện imaplib bên dưới chưa hỗ trợ điều này). Điều này có nghĩa là bạn sẽ
được bảo vệ chống lại những kẻ nghe lén đang nghe thụ động và họ sẽ không thể
xem mật khẩu hoặc nội dung email của bạn. Tuy nhiên, điều này sẽ không bảo vệ bạn khỏi hoạt động
các cuộc tấn công, chẳng hạn như các cuộc tấn công Man-In-The-Middle khiến bạn kết nối sai
máy chủ và giả vờ là máy chủ thư của bạn.

KHÔNG TIN CẬY VÀO SAO NHƯ MỘT KẾT NỐI AN TOÀN ĐẢM BẢO KHẢ NĂNG XÁC THỰC CỦA BẠN
MÁY CHỦ IMAP!

UNIX TÍN HIỆU

OfflineImap lắng nghe các tín hiệu unix SIGUSR1, SIGUSR2, SIGTERM, SIGINT, SIGHUP,
SIGQUIT.

· Nếu được gửi SIGUSR1, nó sẽ hủy bỏ mọi trạng thái ngủ hiện tại (hoặc tương lai tiếp theo) của tất cả các tài khoản
được định cấu hình để "tự động làm mới". Trên thực tế, điều này sẽ kích hoạt đồng bộ hóa hoàn toàn tất cả
tài khoản sẽ được thực hiện càng sớm càng tốt.

· Nếu được gửi một SIGUSR2, nó sẽ dừng "chế độ tự động làm mới" cho tất cả các tài khoản. Đó là, các tài khoản
sẽ hủy bỏ mọi chế độ ngủ hiện tại và sẽ thoát ra sau khi đồng bộ hóa hiện đang chạy
Đã hoàn thành xong. Tín hiệu này có thể được sử dụng để thoát ra khỏi bản đồ ngoại tuyến đang chạy một cách duyên dáng
"daemon".

· Tất cả SIGTERM, SIGINT, SIGHUP đều được xử lý để kết thúc sớm nhất có thể.
Điều này có nghĩa là nó sẽ hoàn tất quá trình đồng bộ hóa thư mục hiện tại trong mỗi tài khoản, hãy đóng tiếp tục hoạt động
kết nối, loại bỏ khóa trên tài khoản và thoát.

Có thể mất đến 10 giây nếu tùy chọn tự động làm mới được sử dụng.

· Nếu được gửi SIGQUIT, kết xuất dấu vết ngăn xếp cho tất cả các luồng và cố gắng kết xuất lõi quy trình.

Được biết đến CÁC VẤN ĐỀ

· SSL3 đang chờ ghi.

Người dùng bật SSL có thể gặp lỗi về "SSL3 ghi đang chờ xử lý". Nếu vậy, (các) tài khoản
sẽ không được đồng bộ hóa kể từ khi lỗi xuất hiện. Chạy lại ngoại tuyếnIMAP có thể
Cứu giúp. Chúng tôi vẫn đang nghiên cứu về lỗi này. Các bản vá hoặc báo cáo lỗi chi tiết sẽ được
đánh giá cao. Vui lòng kiểm tra xem bạn đang chạy phiên bản ổn định cuối cùng và gửi báo cáo cho chúng tôi
vào danh sách gửi thư bao gồm nhật ký đầy đủ.

· Hỗ trợ IDLE chưa hoàn chỉnh và đang thử nghiệm. Có thể gặp lỗi.

· Không có móc nào tồn tại cho "chạy sau một phản hồi IDLE".

Email sẽ hiển thị, nhưng có thể không được xử lý cho đến chu kỳ làm mới tiếp theo.

· Bảng tên có thể không được hỗ trợ chính xác.

· IMAP IDLE <→ IMAP IDLE chưa hoạt động.

· IDLE có thể ngừng đồng bộ khi hệ thống tạm ngừng / tiếp tục.

· IDLE chỉ có thể hoạt động "một lần" mỗi lần làm mới.

Nếu bạn gặp lỗi này, vui lòng gửi báo cáo đến danh sách!

· Hỗ trợ Maildir trong ổ Windows.

Maildir sử dụng ký tự dấu hai chấm (:) trong tên tệp tin. Colon tuy nhiên bị cấm
ký tự trong ổ windows. Có một số cách giải quyết cho tình huống đó:

1. Cho phép dịch ký tự tên tệp trong sổ đăng ký Windows (không được kiểm tra).

· http://support.microsoft.com/kb/289627

2. Sử dụng gắn kết được quản lý bởi cygwin (chưa thử nghiệm).

· Không có sẵn nữa kể từ cygwin 1.7

3. Sử dụng tài khoản "maildir-windows-tương thích = có" cấu hình ngoại tuyếnIMAP.

· Điều đó làm cho OfflineIMAP sử dụng dấu chấm than (!) Thay vì dấu hai chấm cho
lưu trữ tin nhắn. Các tệp như vậy có thể được ghi vào các phân vùng cửa sổ. Nhưng bạn
có thể sẽ mất khả năng tương thích với các chương trình khác đang cố gắng đọc cùng một
Maildir.

· Dấu chấm than được chọn vì ghi chú trong
http://docs.python.org/library/mailbox.html

· Nếu bạn có một số tin nhắn đã được lưu trữ mà không có tùy chọn này, bạn sẽ phải
đồng bộ lại chúng một lần nữa

· Ngoại tuyếnIMAP bị nhầm lẫn sau khi hệ thống tạm ngừng.

Khi tiếp tục một phiên bị tạm dừng, OfflineIMAP không xử lý rõ ràng lỗi bị hỏng
(các) ổ cắm nếu tùy chọn socktimeout không được đặt. Bạn nên bật tùy chọn này với một giá trị
như 10.

· Ngoại tuyếnIMAP nhầm lẫn khi các thư thay đổi trong khi đồng bộ hóa.

Khi OfflineIMAP đang đồng bộ hóa, một số sự kiện xảy ra kể từ khi yêu cầu trên điều khiển từ xa hoặc
địa phương bị xử lý nặng. Ngoại tuyếnIMAP sẽ không theo dõi các thay đổi trong quá trình đồng bộ hóa.

· Chia sẻ maildir với nhiều máy chủ IMAP.

Nói chung, hãy thận trọng khi trộn các kho IMAP trên cùng một thư mục gốc. Bạn
phải cẩn thận rằng bạn không bao giờ sử dụng cùng một thư mục maildir cho 2 máy chủ IMAP. Trong
trường hợp tốt nhất, thư mục MD5 sẽ khác và bạn sẽ nhận được một vòng lặp nơi nó sẽ
lần lượt tải các thư của bạn lên cả hai máy chủ (vô hạn!) vì nó cho rằng bạn đã đặt
thư mới trong Maildir cục bộ. Trong trường hợp xấu nhất, MD5 giống nhau (có thể xảy ra) và
UID thư trùng lặp (cũng có thể xảy ra!) và nó sẽ không thể đồng bộ hóa một số thư vì nó cho rằng chúng
đã tồn tại.

Tôi sẽ tạo một Kho lưu trữ Maildir cục bộ mới cho Gmail Cá nhân và sử dụng
gốc khác nhau để ở bên an toàn ở đây. Ví dụ bạn có thể sử dụng

`~ / mail / Pro`như là gốc Maildir cho ProGmail và
`~ / mail / Personal`như là gốc cho cá nhân.

Nếu sau đó, bạn trỏ chuột cục bộ của mình hoặc bất kỳ MUA nào bạn sử dụng để ~ / mail / là gốc, nó
vẫn nên nhận ra tất cả các thư mục.

· Các trường hợp cạnh có mức tối đa gây ra quá nhiều thư được đồng bộ hóa.

Tất cả tin nhắn từ tối đa ngày trước (+/- vài giờ, tùy thuộc vào múi giờ)
được đồng bộ hóa, nhưng có những trường hợp các thư cũ hơn cũng có thể được đồng bộ hóa. Cái này
xảy ra khi UID của một tin nhắn cao hơn đáng kể so với UID của các tin nhắn khác có
các ngày tương tự, ví dụ: khi tin nhắn được thêm vào thư mục cục bộ đằng sau bản đồ ngoại tuyến
trở lại, khiến họ được gán một UID mới hoặc khi bản đồ ngoại tuyến lần đầu tiên đồng bộ hóa
Maildir tồn tại từ trước. Trong trường hợp thứ hai, nó có thể xuất hiện như thể một điều đáng chú ý và
tập hợp con ngẫu nhiên của các tin nhắn cũ được đồng bộ hóa.

CHỦ YẾU TÁC GIẢ

John Goerzen, Sebastian Spaetz, Eygene Ryabinkin, Nicolas Sebrecht.

Sử dụng offlineimap trực tuyến bằng các dịch vụ onworks.net