The arozos repo

Toby Chui e9e5d33bc5 Added partial relative path support in agi 2 vuotta sitten
documents 1485c2824c replaced log.Println to systemWideLogger.PrintAndLog 3 vuotta sitten
examples 0f84a11f18 Added darknet_arm64 and smart_arm64 binary 3 vuotta sitten
legacy a8239f7d9b Added Code Studio agi syntax highlight 2 vuotta sitten
mod e9e5d33bc5 Added partial relative path support in agi 2 vuotta sitten
subservice 8c06b2ebb1 Updated gzip handler to prevent subservice load fail on Firefox 3 vuotta sitten
system 15a16e614e Delete polyfill 2 vuotta sitten
web a8239f7d9b Added Code Studio agi syntax highlight 2 vuotta sitten
.gitignore db3eec2ec5 reverted main.go 3 vuotta sitten
AGI Documentation.md e9e5d33bc5 Added partial relative path support in agi 2 vuotta sitten
Makefile 3dd7c868ac Added WIP system wide log 3 vuotta sitten
README.md 328858bf9a Added template for nfs abstraction 3 vuotta sitten
agi.go 26245723f0 Name changed from Lambda to ARZ Serverless 2 vuotta sitten
apt.go 3dd7c868ac Added WIP system wide log 3 vuotta sitten
auth.go 3dd7c868ac Added WIP system wide log 3 vuotta sitten
autopush.bat 8052702e98 Updated permission modes 4 vuotta sitten
autopush.sh 8052702e98 Updated permission modes 4 vuotta sitten
build.sh 7ef75ffbd1 Fixed more bugs 3 vuotta sitten
buildFullErrorList.bat 8052702e98 Updated permission modes 4 vuotta sitten
build_binary-only.sh 8052702e98 Updated permission modes 4 vuotta sitten
cluster.go 32bf29e0ab Updated shutdown sequence log 3 vuotta sitten
common.go_disabled f3ed495937 Migrated all root source code to use common module 3 vuotta sitten
console.go f3ed495937 Migrated all root source code to use common module 3 vuotta sitten
desktop.go 157a039467 Updated login interface theme color 3 vuotta sitten
devices.go cdc2320d26 Moved locate.html to info tab 4 vuotta sitten
disk.go 32bf29e0ab Updated shutdown sequence log 3 vuotta sitten
error.go f3ed495937 Migrated all root source code to use common module 3 vuotta sitten
file_system.go 40eae0f5f2 Fixed checkbox not auto check on edit on fshedit 3 vuotta sitten
go.mod 7d05532659 added DB support 2 vuotta sitten
go.sum 7d05532659 added DB support 2 vuotta sitten
hardware.power.go 32bf29e0ab Updated shutdown sequence log 3 vuotta sitten
iot.go f3ed495937 Migrated all root source code to use common module 3 vuotta sitten
ldap.go 41ab40a03d Updated LDAP to make it better 3 vuotta sitten
localhost.crt 40ea2c13f5 Updated certificate 4 vuotta sitten
localhost.key 40ea2c13f5 Updated certificate 4 vuotta sitten
main.flags.go 07b8635ad2 Added experimental fix to auto stoarge pool reload 2 vuotta sitten
main.go 8c06b2ebb1 Updated gzip handler to prevent subservice load fail on Firefox 3 vuotta sitten
main.router.go 1dd379b89a changed the endpoint 2 vuotta sitten
mediaServer.go aab53b790e Fixed issue 105 for ai files turning into pdf 3 vuotta sitten
module.go 32bf29e0ab Updated shutdown sequence log 3 vuotta sitten
module.util.go 0aaf1582e5 Updated many smaller pages from tocasv2 to segmentic 3 vuotta sitten
network.forward.go 1485c2824c replaced log.Println to systemWideLogger.PrintAndLog 3 vuotta sitten
network.ftp.go 32bf29e0ab Updated shutdown sequence log 3 vuotta sitten
network.go d18e547df2 Added web root agi excution feature and removed scheudler 2 vuotta sitten
network.webdav.go f3ed495937 Migrated all root source code to use common module 3 vuotta sitten
notification.go ee4cdd3116 Update notification.go 3 vuotta sitten
oauth.go 52791b19f8 Fixed diskmg unable to render not partitioned disk bug 4 vuotta sitten
openwrt-build.bat 0f84a11f18 Added darknet_arm64 and smart_arm64 binary 3 vuotta sitten
permission.go 1485c2824c replaced log.Println to systemWideLogger.PrintAndLog 3 vuotta sitten
quota.go ed22d4195e Merge branch 'systemLog-20220823' of tmp/arozos into master 3 vuotta sitten
register.go f3ed495937 Migrated all root source code to use common module 3 vuotta sitten
riscv64-build.bat e523a3e131 Added experimental riscv64 support 3 vuotta sitten
scheduler.go d18e547df2 Added web root agi excution feature and removed scheudler 2 vuotta sitten
security.go f3ed495937 Migrated all root source code to use common module 3 vuotta sitten
setting.advance.go f3ed495937 Migrated all root source code to use common module 3 vuotta sitten
setting.go f3ed495937 Migrated all root source code to use common module 3 vuotta sitten
start.sh ecdded5c02 Added localization for authreq 4 vuotta sitten
startup.flags.go 050a88d3fd Optimized File Manager auto refresh during listDir 3 vuotta sitten
startup.go 8ba7e6f7cc Added storage heartbeat system 2 vuotta sitten
storage.bridge.go e9e6976874 Optimized log output for highest abstraction layer 3 vuotta sitten
storage.go 56ced27e29 Added hearbeat ticker stop to close setup 2 vuotta sitten
storage.pool.go 1485c2824c replaced log.Println to systemWideLogger.PrintAndLog 3 vuotta sitten
subservice.go f3ed495937 Migrated all root source code to use common module 3 vuotta sitten
system.go 1485c2824c replaced log.Println to systemWideLogger.PrintAndLog 3 vuotta sitten
system.info.go 4e887ed8e0 Fixed uptime viewing permission 2 vuotta sitten
system.resetpw.go f3ed495937 Migrated all root source code to use common module 3 vuotta sitten
test.go 0f84a11f18 Added darknet_arm64 and smart_arm64 binary 3 vuotta sitten
update-licenses.bat 328858bf9a Added template for nfs abstraction 3 vuotta sitten
user.go 1485c2824c replaced log.Println to systemWideLogger.PrintAndLog 3 vuotta sitten
wifi.go 1485c2824c replaced log.Println to systemWideLogger.PrintAndLog 3 vuotta sitten

README.md

ArozOS

This is the go implementation of ArozOS (aka ArOZ Online) Web Desktop environment,designed to run on linux, but somehow still works on Windows and Mac OS

This README file is intended for developer only. If you are normal users, please refer to the README file outside of the /src folder.

Development Notes

  • Start each module with {ModuleName}Init() function, e.g. WiFiInit()
  • Put your function in mod (if possible) and call it in the main program
  • Do not change the sequence in the startup() function unless necessary
  • When in doubt, add startup flags (and use startup flag to disable experimental functions on startup)

File System Virtualization and File System Abstractions Layers

The ArozOS system contains both the virtualization layer and abstraction layer. The easiest way to check if your path is under which layer is by looking at their starting dir name.

Path Structure Example Path Layer
{vroot_id}:/{subpath} user:/Desktop/myfile.txt File System Virtualization Layer (Highest Layer)
fsh (*File System Handler) + subpath (string) fsh (localfs) + /files/users/alan/Desktop/myfile.txt File System Abstraction
{physical_location}/{subpath} /home/aroz/arozos/files/users/Desktop/myfile.txt Physical (Disk) Layer

Since ArozOS v2.000, we added File System Abstraction (fsa, or sometime as seen as fshAbs, abbr for "File System Handler underlaying File System Abstraction) to the (already complex) File System Handler (fsh) infrastruture. There are two type of fsh that are currently supported by ArozOS File System Abstraction layer.

ArOZ JavaScript Gateway Interface / Plugin Loader

The ArOZ AJGI / AGI interface provide a JavaScript programmable interface for ArozOS users to create plugin for the system. To initiate the module, you can place a "init.agi" file in the web directory of the module (also named the module root). See more details in the AJGI Documentation.

Subservice Logics and Configuration

To intergrate other binary based web server to the subservice interface, you can create a folder inside the "./subservice/your_service" where your binary executable should be named identically with the containing directory. For example, you have a module that provides web ui named "demo.exe", then your should put the demo.exe into "./subservice/demo/demo.exe".

In the case of Linux environment, the subservice routine will first if the module is installed via apt-get by checking with the "which" program. (If you got busybox, it should be built in) If the package is not found in the apt list, the binary of the program will be searched under the subservice directory.

Please follow the naming convention given in the build.sh template. For example, the corresponding platform will search for the corresponding binary excitable filename:

demo_linux_amd64    => Linux AMD64
demo_linux_arm      => Linux ARMv6l / v7l
demo_linux_arm64    => Linux ARM64
demo_macOS_amd64    => MacOS AMD64 

Startup Flags

During the startup of the subservice, two types of parameter will be passed in. Here are the examples

demo.exe -info
demo.exe -port 12810 -rpt "http://localhost:8080/api/ajgi/interface"

In the case of receiving the "info" flag, the program should print the JSON string with correct module information as stated in the struct below.

//Struct for storing module information
type serviecInfo struct{
    Name string                //Name of this module. e.g. "Audio"
    Desc string                //Description for this module
    Group string            //Group of the module, e.g. "system" / "media" etc
    IconPath string            //Module icon image path e.g. "Audio/img/function_icon.png"
    Version string            //Version of the module. Format: [0-9]*.[0-9][0-9].[0-9]
    StartDir string         //Default starting dir, e.g. "Audio/index.html"
    SupportFW bool             //Support floatWindow. If yes, floatWindow dir will be loaded
    LaunchFWDir string         //This link will be launched instead of 'StartDir' if fw mode
    SupportEmb bool            //Support embedded mode
    LaunchEmb string         //This link will be launched instead of StartDir / Fw if a file is opened with this module
    InitFWSize []int         //Floatwindow init size. [0] => Width, [1] => Height
    InitEmbSize []int        //Embedded mode init size. [0] => Width, [1] => Height
    SupportedExt []string     //Supported File Extensions. e.g. ".mp3", ".flac", ".wav"
}

//Example Usage when reciving the -info flag
infoObject := serviecInfo{
        Name: "Demo Subservice",
        Desc: "A simple subservice code for showing how subservice works in ArOZ Online",            
        Group: "Development",
        IconPath: "demo/icon.png",
        Version: "0.0.1",
        //You can define any path before the actualy html file. This directory (in this case demo/ ) will be the reverse proxy endpoint for this module
        StartDir: "demo/home.html",            
        SupportFW: true, 
        LaunchFWDir: "demo/home.html",
        SupportEmb: true,
        LaunchEmb: "demo/embedded.html",
        InitFWSize: []int{720, 480},
        InitEmbSize: []int{720, 480},
        SupportedExt: []string{".txt",".md"},
    }

jsonString, _ := json.Marshal(info);
fmt.Println(string(infoObject))
os.Exit(0);

When receiving the port flag, the program should start the web ui at the given port. The following is an example for the implementation of such functionality.

var port = flag.String("port", ":80", "The default listening endpoint for this subservice")
flag.Parse()
err := http.ListenAndServe(*port, nil)
if err != nil {
    log.Fatal(err)
}

Subservice Exec Settings

In default, subservice routine will create a reverse proxy with URL rewrite build in that serve your web ui launched from the binary executable. If you do not need a reverse proxy connection, want a custom launch script or else, you can use the following setting files.

.noproxy        => Do not start a proxy to the given port
.startscript    => Send the launch parameter to the "start.bat" or "start.sh" file instead of the binary executable
.disabled        => Do not load this subservice during startup. But the user can enable it via the setting interface

Here is an example "start.bat" used in integrating Syncthing into ArOZ Online System with ".startscript" file placed next to the syncthing.exe file.

if not exist ".\config" mkdir ".\config"
syncthing.exe -home=".\config" -no-browser -gui-address=127.0.0.1%2

Systemd support

To enable systemd in your host that support aroz online system, create a bash script at your aroz online root named "start.sh" and fill it up with your prefered startup paratmers. The most basic one is as follow:

#/bin/bash
sudo ./aroz_online_linux_amd64

And then you can create a new file called "arozos.service" in /etc/systemd/system with the following contents (Assume your aroz online root is at /home/pi/arozos)

[Unit]
Description=ArozOS Cloud Desktop Service.

[Service]
Type=simple
WorkingDirectory=/home/pi/arozos/
ExecStart=/bin/bash /home/pi/arozos/start.sh

Restart=always
RestartSec=10

[Install]
WantedBy=multi-user.target

Finally to enable the service, use the following systemd commands

#Enable the script during the startup process
sudo systemctl enable arozos.service

#Start the service now
sudo systemctl start arozos.service

#Show the status of the service
systemctl status arozos.service


#Disable the service if you no longer want it to start during boot
sudo systemctl disable aroz-online.service