22 stable releases (5 major)

Uses old Rust 2015

47.13.0+0.4.7.x Feb 10, 2023
47.8.0+0.4.7.x Jun 28, 2022
47.7.0+0.4.7.x May 27, 2022
46.9.0+0.4.6.x Jan 11, 2022
42.7.0+0.4.2.7 Mar 21, 2020

#3 in #refer

Download history 827/week @ 2024-07-22 622/week @ 2024-07-29 669/week @ 2024-08-05 574/week @ 2024-08-12 686/week @ 2024-08-19 643/week @ 2024-08-26 809/week @ 2024-09-02 728/week @ 2024-09-09 625/week @ 2024-09-16 800/week @ 2024-09-23 627/week @ 2024-09-30 858/week @ 2024-10-07 818/week @ 2024-10-14 634/week @ 2024-10-21 581/week @ 2024-10-28 762/week @ 2024-11-04

2,864 downloads per month
Used in 4 crates

MIT license

26KB
580 lines

libtor

libtor is a Rust crate for bundling inside your project a fully-running Tor daemon. It exposes a nicer interface to operate it compared to the bare-bones version, libtor-sys. If you need further instructions on how to build or cross-compile the project, you should refer to the libtor-sys README.md.

libtor makes it easier for projects on multiple platforms to use Tor without depending on the user to configure complex proxy settings from other external software.

Example

use libtor::{Tor, TorFlag, TorAddress, HiddenServiceVersion};

Tor::new()
    .flag(TorFlag::DataDirectory("/tmp/tor-rust".into()))
    .flag(TorFlag::SocksPort(19050))
    .flag(TorFlag::HiddenServiceDir("/tmp/tor-rust/hs-dir".into()))
    .flag(TorFlag::HiddenServiceVersion(HiddenServiceVersion::V3))
    .flag(TorFlag::HiddenServicePort(TorAddress::Port(8000), None.into()))
    .start()?;

Since Tor uses internally some static variables to keep its state, keep in mind that you can't start more than one Tor instance per process.

Supported platforms

The currently supported platforms are:

  • Linux (tested on Fedora 30 and Ubuntu Xenial)
  • Android through the NDK
  • MacOS
  • iOS
  • Windows cross-compiled from Linux with mingw

Coming Soon ™️:

  • Windows (natively built)

Dependencies

The following dependencies are needed:

  • openssl
  • pkg-config
  • file
  • the "usual" C build tools: a compiler, automake, autoconf

Dependencies

~2.8–6.5MB
~140K SLoC