rev |
line source |
pankso@1
|
1 SliTaz Secure File Storage
|
pankso@1
|
2 ===============================================================================
|
pankso@1
|
3
|
pankso@1
|
4
|
pankso@1
|
5 Ssfs is a personnal and secure, fast and light online file storage powered by
|
pankso@1
|
6 SSH, Rsync, Lsyncd and SHell script. It monitor a local folder and automaticaly
|
pankso@1
|
7 synchronize the remote server, when files are tranfert they are compressed and
|
pankso@1
|
8 encrypted with SSH. Connection to the remote host is automate with a RSA key,
|
pankso@1
|
9 and for each client the key must be sent to the server via SSH password login.
|
pankso@1
|
10
|
pankso@1
|
11 Using ssfs let you have a live synchronized and secure folder between many
|
pankso@1
|
12 computers with an online copy on a secure Linux server. But even without
|
pankso@1
|
13 connections you have access to your files. Connection to the remote server
|
pankso@1
|
14 can also be done using the command line and 'ssh' from any clients such as
|
pankso@1
|
15 BSD, Android, OSX or Windows via Putty.
|
pankso@1
|
16
|
pankso@1
|
17 Ssfs is very easy to install, setup and configure to make you own secure online
|
pankso@1
|
18 file storage. It provide a cmdline tool for the client and the server with a
|
pankso@1
|
19 build in help, this README is also a howto in itself.
|
pankso@1
|
20
|
pankso@1
|
21 On the server side admin can choose by creating standard accounts or chrooted
|
pankso@1
|
22 accounts wich enforce server security by restricting available commands in a
|
pankso@1
|
23 minimal chroot environment. User $HOME should be set to 0700 so users can't see
|
pankso@1
|
24 other users files.
|
pankso@1
|
25
|
pankso@1
|
26
|
pankso@1
|
27 Installation
|
pankso@1
|
28 ------------
|
pankso@1
|
29 To work you need an SSH client, 'rsync' and 'lsyncd' installed, on SliTaz you
|
pankso@1
|
30 can simply install ssfs and it dependencies or to 'make install' from the
|
pankso@8
|
31 source directory (see the Development section).
|
pankso@1
|
32
|
pankso@1
|
33
|
pankso@1
|
34 Client help and setup
|
pankso@1
|
35 ---------------------
|
pankso@1
|
36 The cmdline interface ssfs let you setup a client and start the daemon and live
|
pankso@1
|
37 synchronization with your system session via the Window Manager autostart
|
pankso@8
|
38 script or your personnal ~/.profile file. To get a list of commands with
|
pankso@8
|
39 a short description:
|
pankso@1
|
40
|
pankso@1
|
41 $ ssfs help
|
pankso@1
|
42
|
pankso@1
|
43 To setup a client by creating a Lua configuration file and sending the RSA key
|
pankso@1
|
44 to the server, you can use the command 'setup'. Setup needs a login name and
|
pankso@1
|
45 server name or IP adress and it will also create a secure RSA if no existing:
|
pankso@1
|
46
|
pankso@1
|
47 $ ssfs setup --login=user --host=server
|
pankso@1
|
48
|
pankso@1
|
49
|
pankso@1
|
50 GUI & Web interface
|
pankso@1
|
51 -------------------
|
pankso@8
|
52 Actually they is a smal GTK/Yad but no web interface. The tool ssfs-box will
|
pankso@8
|
53 dipply info if a configuration file exist or start the setup box.
|
pankso@1
|
54
|
pankso@1
|
55
|
pankso@1
|
56 Get configs on boot
|
pankso@1
|
57 -------------------
|
pankso@1
|
58 Ssfs can be used in a boot scripts to connect to remote host and retrive data
|
pankso@1
|
59 before user session is started. It can be usful to provide persitent data for
|
pankso@1
|
60 Live systems and web boot.
|
pankso@1
|
61
|
pankso@1
|
62
|
pankso@1
|
63 Server setup
|
pankso@1
|
64 ------------
|
pankso@1
|
65 On the server you must have a SSH server running and an user account with a
|
pankso@1
|
66 ~/Sync folder. If you want to create a chroot for users you can use use the
|
pankso@1
|
67 tool ssfs-server. Here is a short example to create a chroot and create a user
|
pankso@1
|
68 login 'tux-sync' with a protected $HOME in the chroot, the root directory can
|
pankso@1
|
69 be specified on the command line or changed in the configuration file:
|
pankso@1
|
70
|
pankso@1
|
71 # ssfs-server gen-chroot
|
pankso@1
|
72 # ssfs-server adduser --login=tux-sync --id=2000 --pass=tuX0cc
|
pankso@1
|
73
|
pankso@1
|
74 Users can be listed or completely deleted including all file in home. More
|
pankso@1
|
75 information with: ssfs-server usage
|
pankso@1
|
76
|
pankso@1
|
77
|
pankso@1
|
78 Server users config
|
pankso@1
|
79 -------------------
|
pankso@1
|
80 When adding a user with 'ssfs-server adduser', the user is added to the host
|
pankso@1
|
81 /etc/passwd and a custom user config file is created in SSFS_USERS with the
|
pankso@10
|
82 login name.
|
pankso@1
|
83
|
pankso@1
|
84
|
pankso@1
|
85 Development and Bugs
|
pankso@1
|
86 --------------------
|
pankso@1
|
87 If you want to install latest code to test and help in developement you can
|
pankso@1
|
88 clone ssfs Mercurial repository. As usual cose folloy SliTaz light philosofy
|
pankso@1
|
89 with speed and security in mind:
|
pankso@1
|
90
|
pankso@1
|
91 $ hg clone http://hg.slitaz.org/ssfs
|
pankso@1
|
92
|
pankso@1
|
93 Install with 'make install' (DESTDIR is supported for packaging), update POT
|
pankso@1
|
94 file if any new string have been added with 'make pot' and merger PO files with
|
pankso@1
|
95 the command 'make msgmerge'. Any ideas are welcome and can be discuss, if you
|
pankso@1
|
96 are searching for something to do you can have a look to the TODO file :-)
|
pankso@1
|
97
|
pankso@1
|
98 Bugs can be reported on SliTaz mailing list, forum or scn since devel forum is
|
pankso@1
|
99 synced, all sites are liked from the main website at: http://www.slitaz.org/
|
pankso@1
|
100
|
pankso@1
|
101
|
pankso@1
|
102 ===============================================================================
|
pankso@1
|
103
|