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
|
sftp cloudfs
============
This is a SFTP (Secure File Transfer Protocol) interface to OpenStack
Object Storage, providing a service that acts as a proxy between a
SFTP client and a storage service.
The username/password pair used to open the SFTP session is validated
using the authentication service of the files/storage service to get
an authentication token.
The communication between the client and the SFTP daemon is encrypted
all the time, and the SFTP service supports HTTPS communication with
the remote files/storage service.
There's limited SCP support since 0.10.
Install
-------
Requirements:
- python (2.6)
- paramiko (1.7.6+; 1.10.1 recommended)
- python-swiftclient (1.6+)
- python-daemon (1.5.5)
- ftp-cloudfs (0.25.1+)
- python-memcached (1.45)
These are the minimum recommended versions based in our testing
environment.
You may need to create a host key with ssh-keygen.
To install the software, run following command:
python setup.py install
Or using pip:
pip install sftp-cloudfs
Please use the latest pip version, old versions may have bugs. You
can upgrade pip using pip: pip install --upgrade pip.
Usage
-----
Once installed you can run the service with sftpcloudfs executable,
that supports following options:
--version show program's version number and exit
-h, --help show this help message and exit
-a AUTHURL, --auth-url=AUTHURL
Authentication URL
-k HOST_KEY, --host-key-file=HOST_KEY
Host RSA key used by the server
-b BIND_ADDRESS, --bind-address=BIND_ADDRESS
Address to bind (default: 127.0.0.1)
-p PORT, --port=PORT Port to bind (default: 8022)
--memcache=MEMCACHE Memcache server(s) to be used for cache (ip:port)
-l LOG_FILE, --log-file=LOG_FILE
Log into provided file
-f, --foreground Run in the foreground (don't detach from terminal)
--disable-scp Disable SCP support (default: enabled)
--syslog Enable logging to system logger (daemon facility)
-v, --verbose Show detailed information on logging
--pid-file=PID_FILE Pid file location when in daemon mode
--uid=UID UID to drop the privileges to when in daemon mode
--gid=GID GID to drop the privileges to when in daemon mode
--keystone-auth Use auth 2.0 (Keystone, requires keystoneclient)
--keystone-region-name=REGION_NAME
Region name to be used in auth 2.0
--keystone-tenant-separator=TENANT_SEPARATOR
Character used to separate tenant_name/username in
auth 2.0, default: TENANT.USERNAME
--keystone-service-type=SERVICE_TYPE
Service type to be used in auth 2.0, default: object-
store
--keystone-endpoint-type=ENDPOINT_TYPE
Endpoint type to be used in auth 2.0, default:
publicURL
--config=CONFIG Use an alternative configuration file
The default location for the configuration file is /etc/sftpcloudfs.conf.
Memcache is optional but highly recommended for better performance. Any Memcache
server must be secured to prevent unauthorized access to the cached data.
By default Swift auth 1.0 will be used, and is compatible with OpenStack
Object Storage (Swift) using swauth authentication middleware.
Optionally OpenStack Identity Service 2.0 (*aka* keystone) can be used. Currently
python-keystoneclient (0.3.2+) is required to use auth 2.0 and it can be enabled
with *--keystone-auth* option.
The server supports large files (over the 5GB default) by splitting the files
in parts into a *.part* subdirectory and using a manifest file to access them as
a single file.
Please check the example configuration file for further details.
License
-------
This is free software under the terms of MIT license (check COPYING file
included in this package).
The server is loosely based on the BSD licensed sftpd server code from:
http://code.google.com/p/pyfilesystem/
Contact and support
-------------------
The project website is at:
https://github.com/memset/sftpcloudfs
There you can file bug reports, ask for help or contribute patches.
Authors
-------
- Nick Craig-Wood <nick@memset.com>
- Juan J. Martinez <juan@memset.com>
Contributors
------------
- Christophe Le Guern <c35sys@gmail.com>
- Koert van der Veer <koert@cloudvps.com>
|
