offlineimap - Online di Cloud

PROGRAM:

NAMA

offlineimap - Menyinkronkan kotak surat dan Maildirs

RINGKASAN

peta offline (pilihan)

DESKRIPSI

Sinkronkan akun yang dikonfigurasi dalam file konfigurasi melalui IMAP. Setiap akun memiliki
dua sisi.

Salah satu sisi harus menjadi server IMAP. Sisi lain bisa berupa Maildir atau lainnya
server IMAP.

PILIHAN

-h, --bantuan
Tampilkan ringkasan opsi.

--Versi: kapan
Versi keluaran.

--lari-kering
Jalankan dalam mode lari kering.

Jangan benar-benar mengubah toko apa pun tetapi periksa dan cetak tindakan sinkronisasi apa
akan diambil jika sinkronisasi akan dilakukan. Itu tidak akan secara tepat memberikan yang tepat
informasi apa yang akan terjadi. Jika misalnya kita perlu membuat folder, itu hanya output
akan membuat map X, tetapi bukan berapa banyak dan email mana yang akan ditransfer.

--info
Keluarkan informasi tentang repositori email yang dikonfigurasi.

Berguna untuk debugging dan pelaporan bug. Gunakan bersama dengan opsi -a untuk membatasi
output ke satu akun. Mode ini akan mencegah sinkronisasi yang sebenarnya terjadi dan
keluar setelah mengeluarkan informasi debug.

-1
Batasi operasi multithreading dan jalankan sinkronisasi single-thread saja.

Ini secara efektif mengatur maxsyncaccounts dan semua file konfigurasi maxconnections
variabel ke 1. Ini adalah 1, nomor.

-P
Setel OfflineIMAP ke mode profil.

Program akan membuat DIR (harus belum ada). Saat dijalankan, pembuatan profil Python
informasi tentang setiap utas masuk ke profiledir. Harap dicatat: Opsi ini adalah
hadir untuk debugging dan pengoptimalan saja, dan TIDAK boleh digunakan kecuali Anda memiliki
alasan khusus untuk melakukannya. Ini akan secara signifikan menurunkan kinerja program, mungkin
mengurangi keandalan, dan dapat menghasilkan data dalam jumlah besar. Opsi ini menyiratkan -1
.

-A
Mengganti bagian akun di file konfigurasi.

Memungkinkan seseorang untuk menentukan akun atau kumpulan akun tertentu untuk disinkronkan tanpa harus
untuk mengedit file konfigurasi.

-C
Menentukan file konfigurasi yang akan digunakan.

-D
Mengaktifkan debugging untuk OfflineIMAP.

Ini berguna jika Anda ingin melacak malfungsi atau mencari tahu apa yang terjadi
Dibawah tenda. Opsi ini memerlukan satu atau beberapa jenis debug, dipisahkan dengan koma.
Ini menentukan apa yang sebenarnya akan di-debug, dan sejauh ini menyertakan dua opsi: imap,
utas, maildir atau SEMUA. Opsi imap akan mengaktifkan aliran dan penguraian protokol IMAP
debug. Perhatikan bahwa output mungkin berisi kata sandi, jadi berhati-hatilah untuk menghapusnya
dari output debugging sebelum mengirimnya ke orang lain. Opsi maildir akan
aktifkan debugging untuk operasi Maildir tertentu. Penggunaan opsi debug apa pun (kecuali
benang disertakan), menyiratkan opsi utas tunggal -1.

-l
Kirim log ke .

-s
Kirim log ke syslog.

-F
Hanya sinkronkan folder yang ditentukan.

Nama folder adalah nama folder yang belum diterjemahkan dari repositori jarak jauh. Ini
opsi baris perintah mengesampingkan apa pun filter folder dan folder termasuk opsi di
file konfigurasi.

-k <[bagian:]option=nilai
Ganti opsi file konfigurasi apa pun.

Jika "bagian" dihilangkan, defaultnya adalah "umum". Setiap garis bawah di nama bagian
diganti dengan spasi: misalnya, untuk mengganti opsi "autorefresh" di
Bagian "[Akun Pribadi]" di file konfigurasi akan menggunakan "-k
Account_Personal:autorefresh=30". Ulangi opsi ini sebanyak yang diperlukan untuk mendefinisikan ulang
beberapa pilihan.

-o
Jalankan hanya sekali.

Abaikan pengaturan autorefresh di file konfigurasi.

-q
Jalankan hanya sinkronisasi cepat.

Abaikan pembaruan bendera apa pun di server IMAP. Jika bendera pada IMAP jarak jauh berubah, dan kami
memiliki pesan secara lokal, itu akan dibiarkan tak tersentuh dalam waktu singkat. Pilihan ini adalah
diabaikan jika maxage diatur.

-u
Menentukan antarmuka pengguna alternatif untuk digunakan.

Ini mengesampingkan default yang ditentukan dalam file konfigurasi. UI yang ditentukan dengan
-u akan dipaksa untuk digunakan, bahkan jika pemeriksaan menentukan bahwa itu tidak dapat digunakan. Mungkin
pilihan antarmuka adalah: tenang, dasar, syslog, ttyui, blinkenlights, machineui.

--kolom[= ], --tidak ada kolom
Tampilkan daftar cabang dalam kolom. Lihat kolom variabel konfigurasi.cabang untuk opsi
sintaks.--kolom dan --no-kolom tanpa opsi setara dengan selalu dan tak pernah
masing.

Opsi ini hanya berlaku dalam mode non-verbose.

SINKRONISASI KINERJA

Secara default, kami menggunakan pengaturan yang cukup konservatif yang aman untuk sinkronisasi, tetapi itu mungkin
bukan yang berkinerja terbaik. Setelah Anda menyiapkan dan menjalankan semuanya, Anda mungkin ingin
untuk melihat mempercepat sinkronisasi Anda. Berikut adalah beberapa petunjuk dan tip tentang caranya
untuk mencapainya

1. Gunakan maxconnections > 1.

Secara default kami hanya menggunakan satu koneksi ke server IMAP. Menggunakan 2 atau bahkan 3 kecepatan
hal-hal jauh dalam banyak kasus. Pengaturan ini masuk ke [Repositori XXX]
bagian.

2. Gunakan filter folder.

Sinkronisasi tercepat adalah sinkronisasi yang dapat mengabaikan beberapa folder. Saya mengurutkan kotak masuk saya menjadi bulanan
folder, dan abaikan setiap folder yang berumur lebih dari 2-3 bulan, ini hanya memungkinkan saya
periksa sebagian kecil dari Mail saya di setiap sinkronisasi. Jika Anda belum melakukannya, lakukanlah :).
Lihat bagian folderfilter contoh offlineimap.conf.

3. Cache.

Cache status default adalah file teks biasa yang akan menulis file lengkap
untuk setiap pesan baru (atau bahkan mengubah bendera) ke file sementara. Jika Anda memiliki
banyak file dalam satu folder, ini adalah beberapa ratus kilo hingga megabita untuk setiap email dan
pasti akan membuat segalanya lebih lambat. Saya sarankan untuk menggunakan backend sqlite untuk itu. Lihat
pengaturan status_backend = sqlite pada contoh offlineimap.conf. Kamu akan membutuhkan
memiliki python-sqlite diinstal untuk menggunakan ini. Ini akan menghemat banyak disk
aktivitas. Perhatikan bahwa backend sqlite masih dianggap eksperimental seperti yang dimilikinya
hanya disertakan baru-baru ini (walaupun hilangnya cache status Anda seharusnya tidak
tragedi karena file itu dapat dibangun kembali secara otomatis)

4. Gunakan sinkronisasi cepat.

Sinkronisasi reguler akan meminta semua flag dan semua UID dari semua email di setiap folder yang
membutuhkan waktu yang cukup lama. A cepat sinkronisasi hanya membandingkan jumlah pesan dalam folder
di sisi IMAP (itu akan mendeteksi perubahan bendera di sisi Maildir). A
sinkronisasi cepat pada akun kecil saya akan memakan waktu 7 detik daripada 40 detik. Misalnya, saya
jalankan skrip cron yang melakukan sinkronisasi reguler sekali sehari, dan hanya melakukan sinkronisasi cepat (-q)
menyinkronkan "-f INBOX" di antaranya.

5. Matikan fsync.

Di bagian [umum] Anda dapat mengatur fsync ke True atau False. Jika Anda ingin bermain 110%
aman dan tunggu semua operasi mencapai disk sebelum melanjutkan, Anda dapat mengatur ini
untuk Benar. Jika Anda mengaturnya ke False, Anda kehilangan sebagian dari keamanan itu, menukarnya dengan kecepatan.

PERBAIKAN DARI PLAIN TEKS UNTUK SQLIT CACHE FORMAT

OfflineImap menggunakan cache untuk menyimpan status terakhir dari surat (bendera dll).

Secara historis itu berarti file teks biasa, tetapi baru-baru ini kami memperkenalkan berbasis sqlite
cache, yang membantu kinerja dan penggunaan CPU pada folder besar. Inilah cara meningkatkan
instalasi cache teks biasa yang ada ke yang berbasis sqlite:

1. Sinkronkan untuk memastikan semuanya cukup mirip.

2. Ubah bagian akun menjadi "status_backend = sqlite".

3. Jalankan sinkronisasi baru.

Ini akan mengubah cache teks biasa Anda menjadi cache sqlite (tetapi biarkan yang lama
cache teks di sekitar agar mudah dikembalikan). Ini harus cepat dan tidak melibatkan surat apa pun
atas/download.

4. Lihat apakah itu berhasil! :-)

5. Jika tidak berhasil, kembali ke versi lama atau setel "status_backend = plain"

6. Hapus file cache teks lama.

Setelah Anda yakin itu berfungsi, Anda dapat menghapus ~/.offlineimap/Account-foo/LocalStatus
folder (cache baru akan berada di folder LocalStatus-sqlite)

KEAMANAN DAN SSL

Secara default, OfflineIMAP akan terhubung menggunakan metode apa pun yang openssl mendukung, yaitu
SSLv2, SSLv3, atau TLSv1.

Perhatikan bahwa SSLv2 terkenal tidak aman dan tidak digunakan lagi. Sayangnya, python2 tidak
menawarkan cara mudah untuk menonaktifkan SSLv2. Anda disarankan untuk menguji pengaturan Anda dan memastikan bahwa
server email tidak menggunakan koneksi SSLv2. Gunakan misalnya "openssl s_client -host
mail.server -port 443" untuk mengetahui koneksi yang digunakan secara default.

· Pemeriksaan sertifikat

Sayangnya, secara default kami tidak akan memverifikasi sertifikat server TLS/SSL IMAP
kami terhubung, jadi menghubungkan dengan SSL bukan jaminan terhadap serangan man-in-the-middle.
Saat memverifikasi sertifikat server, pemeriksaan sidik jari dianjurkan. Ada
saat ini hanya satu cara aman untuk memastikan bahwa Anda terhubung ke server yang benar dalam
cara terenkripsi: Anda dapat menentukan file sslcacert pengaturan di bagian repositori Anda
dari offlineimap.conf menunjuk ke file yang berisi (antara lain) Sertifikat CA
dalam format PEM yang memvalidasi sertifikat server Anda. Dalam hal ini, kami akan memeriksa
bahwa:

1. Sertifikat SSL server divalidasi oleh Sertifikat CA.

2. Nama host server cocok dengan sertifikat SSL.

3. Sertifikat server tidak melewati tanggal kedaluwarsa.

FAQ memiliki entri tentang cara membuat sertifikat dan sertifikat CA Anda sendiri.

· MulaiTLS

Jika Anda belum mengonfigurasi akun Anda untuk terhubung melalui SSL, OfflineImap akan
masih mencoba mengatur koneksi SSL melalui fungsi STARTTLS, jika imap
server mendukungnya.

Tidak ada pemeriksaan sertifikat atau sidik jari sama sekali, saat menggunakan STARTTLS
(pustaka imaplib yang mendasarinya belum mendukung ini). Ini berarti Anda akan
dilindungi dari penyadap yang mendengarkan secara pasif dan mereka tidak akan dapat
melihat kata sandi atau isi email Anda. Namun, ini tidak akan melindungi Anda dari aktif
serangan, seperti serangan Man-In-The-Middle yang menyebabkan Anda terhubung ke yang salah
server dan berpura-pura menjadi server email Anda.

JANGAN MENGANDALKAN STARTTLS SEBAGAI KONEKSI AMAN MENJAMIN KEASLIAN
SERVER IMAP!

UNIX SINYAL

OfflineImap mendengarkan sinyal unix SIGUSR1, SIGUSR2, SIGTERM, SIGINT, SIGHUP,
SIGQUIT.

· Jika mengirim SIGUSR1 itu akan membatalkan tidur saat ini (atau masa depan berikutnya) dari semua akun
yang dikonfigurasi untuk "autorefresh". Akibatnya, ini akan memicu sinkronisasi penuh semua
akun yang harus dilakukan sesegera mungkin.

· Jika mengirim SIGUSR2, itu akan menghentikan "mode autorefresh" untuk semua akun. Artinya, akun
akan membatalkan tidur saat ini dan akan keluar setelah sinkronisasi yang sedang berjalan
telah selesai. Sinyal ini dapat digunakan untuk keluar dengan anggun dari peta offline yang sedang berjalan
"daemon".

· SIGTERM, SIGINT, SIGHUP semua diperlakukan untuk mengakhiri dengan anggun sesegera mungkin.
Ini berarti akan menyelesaikan sinkronisasi folder saat ini di setiap akun, tutup tetap hidup
koneksi, hapus kunci pada akun dan keluar.

Mungkin diperlukan waktu hingga 10 detik, jika opsi penyegaran otomatis digunakan.

· Jika mengirim SIGQUIT, membuang jejak tumpukan untuk semua utas dan mencoba membuang inti proses.

DIKETAHUI MASALAH

· SSL3 menulis tertunda.

Pengguna yang mengaktifkan SSL mungkin menemukan bug tentang "SSL3 write pending". Jika demikian, akun
akan tetap tidak sinkron sejak bug muncul. Jalankan OfflineIMAP lagi bisa
Tolong. Kami masih mengerjakan bug ini. Tambalan atau laporan bug terperinci adalah
dihargai. Harap periksa apakah Anda menjalankan versi stabil terakhir dan kirimkan laporan kepada kami
ke milis termasuk log lengkap.

· Dukungan IDLE tidak lengkap dan eksperimental. Bug mungkin ditemui.

· Tidak ada pengait untuk "jalankan setelah respons IDLE".

Email akan muncul, tetapi mungkin tidak diproses hingga siklus penyegaran berikutnya.

· nametrans mungkin tidak didukung dengan benar.

· IMAP IDLE <→ IMAP IDLE belum berfungsi.

· IDLE mungkin berhenti menyinkronkan pada sistem yang ditangguhkan/dilanjutkan.

· IDLE hanya dapat bekerja "sekali" per penyegaran.

Jika Anda menemukan bug ini, silakan kirim laporan ke daftar!

· Dukungan Maildir di drive Windows.

Maildir menggunakan tanda titik dua (:) dalam nama file pesan. Namun usus besar dilarang
karakter di drive windows. Ada beberapa solusi untuk situasi itu:

1. Aktifkan terjemahan karakter nama file di registri windows (tidak diuji).

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

2. Gunakan mount terkelola cygwin (tidak diuji).

· tidak tersedia lagi sejak cygwin 1.7

3. Gunakan akun "maildir-windows-compatible = yes" konfigurasi OfflineIMAP.

· Itu membuat OfflineIMAP menggunakan tanda seru (!) bukan titik dua untuk
menyimpan pesan. File tersebut dapat ditulis ke partisi windows. Tapi kamu
mungkin akan kehilangan kompatibilitas dengan program lain yang mencoba membaca yang sama
surat menyurat.

· Tanda seru dipilih karena catatan di
http://docs.python.org/library/mailbox.html

· Jika Anda memiliki beberapa pesan yang sudah disimpan tanpa opsi ini, Anda harus
sinkronkan ulang lagi

· OfflineIMAP bingung setelah sistem ditangguhkan.

Saat melanjutkan sesi yang ditangguhkan, OfflineIMAP tidak menangani yang rusak dengan bersih
socket(s) jika opsi socktimeout tidak disetel. Anda harus mengaktifkan opsi ini dengan nilai
seperti 10.

· OfflineIMAP bingung saat email berubah saat disinkronkan.

Saat OfflineIMAP sedang disinkronkan, beberapa peristiwa terjadi sejak pemanggilan di remote atau
pihak lokal tidak ditangani dengan baik. OfflineIMAP tidak akan melacak perubahan selama sinkronisasi.

· Berbagi maildir dengan beberapa server IMAP.

Umumnya kata hati-hati mencampur repositori IMAP pada root Maildir yang sama. Anda
harus berhati-hati bahwa Anda tak pernah gunakan folder maildir yang sama untuk 2 server IMAP. Di dalam
kasus terbaik, folder MD5 akan berbeda, dan Anda akan mendapatkan loop di mana itu akan
unggah email Anda ke kedua server secara bergantian (tanpa batas!)
mail baru di Maildir lokal. Dalam kasus terburuk, MD5 sama (mungkin) dan
UID email tumpang tindih (mungkin juga!) dan itu akan gagal menyinkronkan beberapa email seperti yang dipikirkannya
sudah ada.

Saya akan membuat Repositori Maildir lokal baru untuk Gmail Pribadi dan menggunakan a
root yang berbeda berada di sisi yang aman di sini. Anda bisa misalnya menggunakan

`~/mail/Pro` sebagai root Maildir untuk ProGmail dan
`~/mail/Pribadi` sebagai root untuk yang pribadi.

Jika Anda kemudian menunjuk mutt lokal Anda, atau MUA apa pun yang Anda gunakan untuk ~/surat/ sebagai root, itu
masih harus mengenali semua folder.

· Kasus tepi dengan maxage menyebabkan terlalu banyak pesan untuk disinkronkan.

Semua pesan dari maksimal hari yang lalu (+/- beberapa jam, tergantung pada zona waktu)
disinkronkan, tetapi ada kasus di mana pesan lama juga dapat disinkronkan. Ini
terjadi ketika UID pesan secara signifikan lebih tinggi daripada pesan lain dengan
tanggal yang sama, misalnya ketika pesan ditambahkan ke folder lokal di belakang offlineimap's
kembali, menyebabkan mereka mendapatkan UID baru, atau saat offlineimap pertama kali menyinkronkan
Maildir yang sudah ada sebelumnya. Dalam kasus terakhir, itu bisa tampak seolah-olah terlihat dan
subset acak dari pesan lama disinkronkan.

UTAMA PENULIS

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

Gunakan offlineimap online menggunakan layanan onworks.net