-
Notifications
You must be signed in to change notification settings - Fork 1
/
Copy pathREADME.tpl
174 lines (153 loc) · 9.52 KB
/
README.tpl
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
# LFTP Docker image running on Alpine Linux
[](https://hub.docker.com/r/maurosoft1973/alpine-lftp/)
[](https://hub.docker.com/r/maurosoft1973/alpine-lftp/)
[](https://hub.docker.com/r/maurosoft1973/alpine-lftp/)
[](https://alpinelinux.org/)
The Docker images [(maurosoft1973/alpine-lftp)](https://hub.docker.com/r/maurosoft1973/alpine-lftp/) is based on the minimal [Alpine Linux](https://alpinelinux.org/) with [LFTP Version v%LFTP_VERSION%](https://lftp.yar.ru/).
##### Alpine Version %ALPINE_VERSION% (Released %ALPINE_VERSION_DATE%)
##### LFTP Version %LFTP_VERSION% (Released %LFTP_VERSION_DATE%)
## Description
The LFTP is a sophisticated file transfer program supporting a number of network protocols (ftp, http, sftp, fish, torrent). Like BASH, it has job control and uses the readline library for input. It has bookmarks, a built-in mirror command, and can transfer several files in parallel. It was designed with reliability in mind. LFTP is free software, distributed under the GNU GPL license.
For more information [(lftp)](https://lftp.yar.ru/features.html)
LFTP includes the following features (some may be missed in this list):
* FTP and HTTP protocols support.
* FTP (e.g. TIS FWTK) proxy support.
* HTTP proxy support.
* FTP over HTTP proxy support (hftp and CONNECT method).
* HTTPS and FTPS protocols support using GNU TLS or OpenSSL library.
* Automatic OPIE/SKEY support in FTP protocol.
* FXP transfers support (between two FTP servers, bypassing client machine).
* FTP listings support: unix-style, NT, EPLF, OS/2, AS400, MacWebStar, MLSD.
* FTP implicit compression (MODE Z) support.
* Automatic reconnect and retry of an operation on retriable errors or timeout.
* IPv6 support in both FTP and HTTP.
* FISH protocol support. It uses ssh with no special program on server side.
* SFTP protocol v3-v6 support.
* HTTP/1.1 keep-alive support.
* HTTP basic and digest authentication.
* Partial WebDAV support.
* BitTorrent protocol support (including IPv6).
* BitTorrent extensions: Fast, DHT, PEX, Multi-tracker, Metadata, magnet.
* Experimental support for SRV DNS records.
* SOCKS support (configure option).
* Modification time preservation (if server can report it).
* reget and reput support.
* Built-in mirror and reverse mirror (mirror -R).
* Transfer rate throttling for each connection, for each host and for all connections in total.
* Limit for number of connections to the same site. Interruption of background transfer to do a foreground operation when the limit is reached.
* Socket options tuning: buffer size and maximum segment size.
* Job queueing.
* Job execution at specified time.
* Comprehensive scripting support.
* URL recognition in most operations.
* Readline library is used for input.
* Context sensitive completion.
* Bash-like prompt extensions.
* Launching of local shell commands.
* Suspend support.
* Bookmarks.
* Aliases.
* Saving of last directory on each site. `cd -' to go there.
* Copying of files (including mirror) between two servers over the client, automatic usage of FXP when possible to bypass the client.
* Numerous settings which can be associated with a specific server or a group.
* Paging of remote files using external program.
* zcat and zmore support.
* Help for commands.
* Command history saved in a file.
* Transfer status includes rate and ETA.
* File listing cache.
* Background jobs (bash-like).
* Job output redirection to a file or to a program via pipe.
* Conditional commands depending on exit status of previous one.
* Loading of binary modules at run time (configure option).
* pget to download a file using several connections. `pget' download can be continued as it saves a status file periodically.
* mirror can download several files in parallel (--parallel option) and a single file with `pget' (--use-pget-n option).
* Slots. Each slot is a separate session, switch using Meta-{1-9} or `slot' command. Refer to a slot site using pseudo URL slot:name.
## Architectures
* ```:aarch64``` - 64 bit ARM
* ```:armhf``` - 32 bit ARM v6
* ```:armv7``` - 32 bit ARM v7
* ```:ppc64le``` - 64 bit PowerPC
* ```:x86``` - 32 bit Intel/AMD
* ```:x86_64``` - 64 bit Intel/AMD (x86_64/amd64)
## Tags
* ```:latest``` latest branch based (Automatic Architecture Selection)
* ```:aarch64``` latest 64 bit ARM
* ```:armhf``` latest 32 bit ARM v6
* ```:armv7``` latest 32 bit ARM v7
* ```:ppc64le``` latest 64 bit PowerPC
* ```:x86``` latest 32 bit Intel/AMD
* ```:x86_64``` latest 64 bit Intel/AMD
* ```:test``` test branch based (Automatic Architecture Selection)
* ```:test-aarch64``` test 64 bit ARM
* ```:test-armhf``` test 32 bit ARM v6
* ```:test-armv7``` test 32 bit ARM v7
* ```:test-ppc64le``` test 64 bit PowerPC
* ```:test-x86``` test 32 bit Intel/AMD
* ```:test-x86_64``` test 64 bit Intel/AMD
* ```:%ALPINE_VERSION%``` %ALPINE_VERSION% branch based (Automatic Architecture Selection)
* ```:%ALPINE_VERSION%-aarch64``` %ALPINE_VERSION% 64 bit ARM
* ```:%ALPINE_VERSION%-armhf``` %ALPINE_VERSION% 32 bit ARM v6
* ```:%ALPINE_VERSION%-armv7``` %ALPINE_VERSION% 32 bit ARM v7
* ```:%ALPINE_VERSION%-ppc64le``` %ALPINE_VERSION% 64 bit PowerPC
* ```:%ALPINE_VERSION%-x86``` %ALPINE_VERSION% 32 bit Intel/AMD
* ```:%ALPINE_VERSION%-x86_64``` %ALPINE_VERSION% 64 bit Intel/AMD
* ```:%ALPINE_VERSION%-%LFTP_VERSION%``` %ALPINE_VERSION%-%LFTP_VERSION% branch based (Automatic Architecture Selection)
* ```:%ALPINE_VERSION%-%LFTP_VERSION%-aarch64``` %ALPINE_VERSION% 64 bit ARM
* ```:%ALPINE_VERSION%-%LFTP_VERSION%-armhf``` %ALPINE_VERSION% 32 bit ARM v6
* ```:%ALPINE_VERSION%-%LFTP_VERSION%-armv7``` %ALPINE_VERSION% 32 bit ARM v7
* ```:%ALPINE_VERSION%-%LFTP_VERSION%-ppc64le``` %ALPINE_VERSION% 64 bit PowerPC
* ```:%ALPINE_VERSION%-%LFTP_VERSION%-x86``` %ALPINE_VERSION% 32 bit Intel/AMD
* ```:%ALPINE_VERSION%-%LFTP_VERSION%-x86_64``` %ALPINE_VERSION% 64 bit Intel/AMD
## Layers & Sizes
| Version | Size |
|---------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------|
|  |  |
|  |  |
|  |  |
|  |  |
|  |  |
## Environment Variables:
### Main LFTP parameters:
* `LC_ALL`: default locale (en_GB.UTF-8)
* `TIMEZONE`: default timezone (Europe/Brussels)
* `SHELL_TERMINAL`: default shell (bin/sh)
## Sample Use with gitlab pipeline
The script below allows you to synchronize files on a remote server, excluding hidden files and folders (-X .* -X .*/)
The script git_restore_last_modified_time sets the last modified date on the repository files before syncronized.
```yalm
stages:
- deploy
deploy-develop:
stage: deploy
image: maurosoft1973/alpine-lftp
variables:
FTP_SERVER: 'ftp server'
FTP_PORT: 'ftp port'
FTP_USERNAME: 'ftp username'
FTP_PASSWORD: 'ftp password'
FTP_LOCAL_FOLDER: 'local folder'
FTP_REMOTE_FOLDER: 'remote folder'
only:
- develop
script:
- git_restore_last_modified_time
- lftp -e "set ssl:verify-certificate no; set ftp:use-mdtm-overloaded true; open $FTP_SERVER; user $FTP_USERNAME $FTP_PASSWORD; mirror -X .* -X .*/ --reverse --verbose --delete $FTP_LOCAL_FOLDER $FTP_REMOTE_FOLDER; bye"
deploy-prod:
stage: deploy
image: maurosoft1973/alpine-lftp
variables:
FTP_SERVER: 'ftp server'
FTP_PORT: 'ftp port'
FTP_USERNAME: 'ftp username'
FTP_PASSWORD: 'ftp password'
FTP_LOCAL_FOLDER: 'local folder'
FTP_REMOTE_FOLDER: 'remote folder'
only:
- prod
script:
- git_restore_last_modified_time
- lftp -e "set ssl:verify-certificate no; set sftp:auto-confirm yes; open sftp://$FTP_SERVER -p $FTP_PORT -u $FTP_USERNAME,$FTP_PASSWORD; mirror -X .* -X .*/ --reverse --verbose --delete $FTP_LOCAL_FOLDER $FTP_REMOTE_FOLDER; bye"
```
***
###### Last Update %LAST_UPDATE%