Skip to content
Simple Secure Network File System - Coming Soon
C C++ PHP PLpgSQL Python QMake Other
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
Common feat: Implement Shares management page. Aug 24, 2018
SSNFS-client fix: Fix bug caused `readdir` to fail on directories with many files. Sep 6, 2018
SSNFSd
fastpbkdf2 feat: Rethink DB to work with the new user accounts idea. May 17, 2018
old-SSNFS-client chore: Housekeeping... Mar 15, 2018
.git-commit-template.txt docs: Specify commit message template Feb 7, 2018
.gitignore chore: gitignore a build/ folder. Jul 8, 2018
.gitmodules
LICENSE Change from LGPL to GPL from now on. May 17, 2018
README.md Update README.md Aug 25, 2018
SSNFS.pro fix: Disable qDebug messages on release build. Aug 25, 2018

README.md

SSNFS - A Simple, Secure Network File System

Join the chat at https://gitter.im/SSNFS/Lobby

Why?

The reason I started this project is because currently, there is no network file transfer protocol that is:

  • Secure
  • Robust
  • Easy to setup

For example, in the Linux world there is NFS, but it has no security what-so-ever (without any separate tunneling). In the Windows world, there is Samba. Things are a little better here, but it still has no traffic encryption (by default) and may not be trivial to set up.

The goal

This project's goal is to create a simple way to mount a directory located on a server to one or more clients using the most security conscientious way available.

Progress

  • Read only mode (Completed)
  • Read Write mode (Completed)
  • Configuration (Completed)
  • Managment interface (In Progress)

Building

First, clone the repository as well as the submodules: git clone --recursive https://github.com/MDTech-us-MAN/SSNFS.git

Or, if you already cloned the repository, but forgot to include --recursive, just run the following command in the repository directory: git submodule update --init --recursive

Before building, be sure to have Qt5 (qt5-default in Ubuntu) and libssl (libssl-dev in Ubuntu) already installed. For the client, you will also need libfuse2 (libfuse-dev in Ubuntu).

By default the PREFIX is set to /usr/local for release builds or the build directory for debug builds. If you would like to change this, simply add PREFIX=<new path> to the qmake line.

To build both client and server:

mkdir build
cd build
qmake ..
make
sudo make install

To build only server:

mkdir build-server
cd build-server
qmake "CONFIG+=server" ..
make
sudo make install

To build only client:

mkdir build-client
cd build-client
qmake "CONFIG+=client" ..
make
sudo make install

Usage

To set up the server, simply run the server executable with the --init option. This will start an interactive configuration system.

To access the server's web administration panel, just point your web browser to HTTPS port 2050 of the server.

To register a client with the server, run SSNFS-client register <Server Host>:<Server Port>.

Unfortunatly, a complete managment interface is not fully ready yet. It is currently activly being developed and should be ready soon. Until then, there may be some cases where you may need to edit the config.db using a SQLite3 capable editor.

On the client side, simply use the standard mount syntax: SSNFS-client <Server Host>:<Server Port>/<Share Name> <Mount Directory>

Contributing

Please let us know on Gitter what you are working on so we can better coordinate our efforts.

Coding style

This project uses the Google C++ Style Guide

Commit Message Template

Please set .git-commit-template.txt as your commit message template and follow the rules set forth therein. To do so, simply run the following command in the project root directory:

git config commit.template .git-commit-template.txt

Read this post for more info.

You can’t perform that action at this time.