Konfigurisanje ONLYOFFICE Docs Community izdanja

Uvod

Da biste promenili bilo koje postavke servera ONLYOFFICE Docs, konfigurišite odgovarajući parametar u konfiguracionom fajlu ONLYOFFICE Docs, koji se nalazi na sledećoj putanji:

• Za Linux - /etc/onlyoffice/documentserver/default.json
• Za Windows - %ProgramFiles%\ONLYOFFICE\DocumentServer\config\default.json

Ako želite da ga promenite, možete koristiti fajl local.json, gde bi svi izmenjeni parametri trebalo da budu sačuvani. Ovaj fajl se nalazi u istom direktorijumu kao i fajl default.json, i cela struktura objekta za neophodni parametar mora biti zadržana.

Konfiguracioni fajlovi se čitaju u sledećem redosledu prioriteta (najviši prioritet poslednji):

1. default.json — osnovne podrazumevane vrednosti (ne uređujte)
2. production.json — nadjačavanja za produkciju
3. local.json — vaše prilagođene postavke (uređujte ovaj fajl)
4. runtime.json — postavke promenjene putem Admin Panela (ima najviši prioritet)

Ako je parametar postavljen u više fajlova, koristi se vrednost iz fajla sa najvišim prioritetom.

Podrazumevane postavke servera su opisane ispod.

Uobičajeni scenariji konfiguracije

Slede najčešći zadaci konfiguracije i uključeni parametri:

• Povezivanje sa eksternom bazom podataka: Postavite services.CoAuthoring.sql.type, services.CoAuthoring.sql.dbHost, services.CoAuthoring.sql.dbPort, services.CoAuthoring.sql.dbName, services.CoAuthoring.sql.dbUser, services.CoAuthoring.sql.dbPass. Za Docker koristite promenljive okruženja DB_TYPE, DB_HOST, DB_PORT, DB_NAME, DB_USER, DB_PWD.
• Omogućavanje monitoringa: Postavite statsd.useMetrics na true i konfigurišite statsd.host, statsd.port. Za Docker koristite METRICS_ENABLED, METRICS_HOST, METRICS_PORT.
• Ograničavanje pristupa po IP adresi: Pogledajte vodič za konfiguraciju IP filtera.
• Promena JWT tajne: Postavite services.CoAuthoring.secret.session.string i povezane ključeve. Za Docker koristite JWT_SECRET. Pogledajte vodič za konfiguraciju JWT.
• Korišćenje prilagođenog Redis servera: Postavite services.CoAuthoring.redis.host, services.CoAuthoring.redis.port. Za Docker koristite REDIS_SERVER_HOST, REDIS_SERVER_PORT.

Admin Panel

Ovi parametri definišu svojstva Admin Panela. Za više detalja o korišćenju Admin Panela, možete se obratiti ovom članku.

Primer

"adminPanel": {
    "port": 9000
  }

StatsD

Ovi parametri definišu svojstva StatsD servera, specificirajući agregator metrika.

Primer

"statsd": {
    "useMetrics": false,
    "host": "localhost",
    "port": "8125",
    "prefix": "ds."
}

Postavke AI dodatka

Ovi parametri definišu svojstva AI dodatka.

Primer

"aiSettings": {
    "actions": {},
    "models": [],
    "providers": {},
    "version": 3,
    "timeout": "5m",
    "allowedCorsOrigins": ["https://onlyoffice.github.io", "https://onlyoffice-plugins.github.io"],
    "proxy": ""
  }

Logger

Ovi parametri definišu svojstva logera.

Primer

"log": {
    "filePath": "",
    "options": {
        "replaceConsole": true
    }
}

Runtime konfiguracija

Ovi parametri definišu svojstva dinamičke konfiguracione datoteke runtime.json. Ova datoteka omogućava promenu parametara bez ponovnog pokretanja. Datoteka se ponovo učitava na osnovu događaja nadgledanja ili svakih 5 minuta.

Primer

"runtimeConfig": {
    "filePath": "",
    "cache": {
      "stdTTL": 300,
      "checkperiod": 60,
      "useClones": false
    }
  }

Redovi

Ovi parametri definišu red poruka primljenih od posrednika poruka.

Primer

"queue": {
    "type": "rabbitmq",
    "visibilityTimeout": 300,
    "retentionPeriod": 900
}

Email

Ovi parametri definišu podešavanja spoljnog mail servera, koji se koristi za slanje notifikacija Da biste se povezali sa mail serverom, koristite biblioteku nodemailer. Mnoge postavke konfiguracije se direktno prosleđuju ovoj biblioteci.

Primer

"email": {
    "smtpServerConfiguration": {
        "host": "localhost",
        "port": 587,
        "auth": {
            "user": "",
            "pass": ""
        }
    },
    "connectionConfiguration": {
        "disableFileAccess": false,
        "disableUrlAccess": false
    },
    "contactDefaults": {
        "from": "from@example.com",
        "to": "to@example.com"
    }
}

Obaveštenje

Ovi parametri definišu podešavanja obaveštenja.

Obaveštenja sa sledećim tipovima događaja i sadržajem se šalju:

• Prekoračeno je 70% kvote konekcija (kvote jedinstvenih korisnika).

  Upozorenje o limitu konekcija licence: "Pažnja! Dostigli ste 70% limita konekcija postavljenog vašom licencom."

• Dostignuta je kvota konekcija (kvota jedinstvenih korisnika).

  Upozorenje o limitu konekcija licence: "Pažnja! Dostigli ste 100% limita konekcija postavljenog vašom licencom."

• 30 dana pre nego što licenca istekne.

  Upozorenje o isteku licence: "Pažnja! Vaša licenca će isteći 8. septembra 2024. Nakon ovog datuma, više nećete imati pravo na ličnu tehničku podršku i instalaciju novih verzija Docs-a objavljenih nakon ovog datuma."

• Licenca je istekla.

  Upozorenje o limitu konekcija licence: "Pažnja! Vaša licenca je istekla 8. septembra 2024. Više nemate pravo na ličnu tehničku podršku i instalaciju novih verzija Docs-a objavljenih nakon ovog datuma. Molimo kontaktirajte sales@onlyoffice.com da razgovarate o obnavljanju licence."

Ova obaveštenja se beleže u server log sa WARN ili ERROR nivoom.

Primer

"notification": {
"rules": {
"licenseExpirationWarning": {
"enable": false,
"transportType": [
"email"
],
"template": {
"title": "%s Docs license expiration warning",
"body": "Pažnja! Vaša licenca će isteći %s.\nNakon ovog datuma, više nećete imati pravo na ličnu tehničku podršku i instalaciju novih verzija Docs-a objavljenih nakon ovog datuma."
},
"policies": {
"repeatInterval": "1d"
}
},
"licenseExpirationError": {
"enable": false,
"transportType": [
"email"
],
"template": {
"title": "%s Docs license expiration warning",
"body": "Pažnja! Vaša licenca je istekla %s.\nViše nemate pravo na ličnu tehničku podršku i instalaciju novih verzija Docs-a objavljenih nakon ovog datuma.\nMolimo kontaktirajte sales@onlyoffice.com da razgovarate o obnavljanju licence."
},
"policies": {
"repeatInterval": "1d"
}
},
"licenseLimitEdit": {
"enable": false,
"transportType": [
"email"
],
"template": {
"title": "%s Docs license connection limit warning",
"body": "Pažnja! Dostigli ste %s%% od %s limita postavljenog vašom licencom."
},
"policies": {
"repeatInterval": "1h"
}
},
"licenseLimitLiveViewer": {
"enable": false,
"transportType": [
"email"
],
"template": {
"title": "%s Docs license connection limit warning",
"body": "Pažnja! Dostigli ste %s%% od limita za live viewere %s postavljenog vašom licencom."
},
"policies": {
"repeatInterval": "1h"
}
}
}
}

Servis za skladištenje dokumenata

Ovi parametri definišu konfiguraciju usluge skladištenja dokumenata.

Primer

"storage": {
    "name": "storage-fs",
    "fs": {
      "folderPath": "",
      "urlExpires": 900,
      "secretString": "verysecretstring"
    },
    "region": "",
    "endpoint": "http://localhost/s3",
    "bucketName": "cache",
    "storageFolderName": "files",
    "cacheFolderName": "data",
    "commandOptions": {
      "s3": {
        "putObject": {},
        "getObject": {},
        "copyObject": {
          "MetadataDirective": "COPY"
        },
        "listObjects": {
          "MaxKeys": 1000
        },
        "deleteObject": {}
      },
      "az": {
        "uploadData": {},
        "uploadStream": {},
        "download": {},
        "syncCopyFromURL": {},
        "listBlobsFlat": {
          "maxPageSize": 1000
        },
        "deleteBlob": {}
      }
    },
    "urlExpires": 604800,
    "accessKeyId": "",
    "secretAccessKey": "",
    "sslEnabled": false,
    "s3ForcePathStyle": true,
    "externalHost": "",
    "useDirectStorageUrls": false
  }

Persistentno skladište

Ovi parametri definišu postavke za persistentno skladište, koje se koristi za razdvajanje postavki za skladištenje keširanih datoteka dokumenata i skladištenje zaboravljenih i greškom nastalih datoteka. Postavke koje nisu navedene u ovom objektu se nasleđuju iz storage objekta. Razdvajanje je pogodno za nadogradnje servera.

Primer

"persistentStorage": {
}

RabbitMQ

Ovi parametri definišu konfiguraciju RabbitMQ message brokera.

Primer

"rabbitmq": {
    "url": "amqp://localhost:5672",
    "socketOptions": {},
    "exchangepubsub": {
        "name": "ds.pubsub",
        "options": {
            "durable": true
        }
    },
    "queuepubsub": {
        "name": "",
        "options": {
            "autoDelete": true,
            "exclusive": true,
            "arguments": {
                "x-queue-type": "classic"
            }
        }
    },
    "queueconverttask": {
        "name": "ds.converttask6",
        "options": {
            "durable": true,
            "maxPriority": 6,
            "arguments": {
                "x-queue-type": "classic"
            }
        }
    },
    "queueconvertresponse": {
        "name": "ds.convertresponse",
        "options": {
            "durable": true,
            "arguments": {
                "x-queue-type": "classic"
            }
        }
    },
    "exchangeconvertdead": {
        "name": "ds.exchangeconvertdead",
        "options": {
            "durable": true
        }
    },
    "queueconvertdead": {
        "name": "ds.convertdead",
        "options": {
            "durable": true,
            "arguments": {
                "x-queue-type": "classic"
            }
        }
    },
    "queuedelayed": {
        "name": "ds.delayed",
        "options": {
            "durable": true,
            "arguments": {
                "x-queue-type": "classic"
            }
        }
    }
}

ActiveMQ

Ovi parametri definišu konfiguraciju ActiveMQ posrednika poruka.

Primer

"activemq": {
    "connectOptions": {
        "port": 5672,
        "host": "localhost",
        "reconnect": false
    },
    "queueconverttask": "ds.converttask",
    "queueconvertresponse": "ds.convertresponse",
    "queueconvertdead": "ActiveMQ.DLQ",
    "queuedelayed": "ds.delayed",
    "topicpubsub": "ds.pubsub"
}

DNS keš

Ovi parametri definišu konfiguraciju DNS keša koji se koristi za IP-filter.

Primer

"dnscache": {
    "enable" : true,
    "ttl" : 300,
    "cachesize" : 1000
}

OpenPGP protokol

Ovi parametri definišu postavke OpenPGP protokola, koji se koristi za enkripciju lozinke prilikom otvaranja enkriptovanog dokumenta za uređivanje.

Primer

"openpgpjs": {
    "config": {
    },
    "encrypt": {
        "passwords": ["verysecretstring"]
    },
    "decrypt": {
        "passwords": ["verysecretstring"]
    }
}

AES-256-GCM algoritam

Ovi parametri definišu postavke AES-256-GCM algoritma enkripcije koji se koristi za zaštitu dokumenata lozinkom.

Primer

"aesEncrypt": {
    "config": {
        "keyByteLength": 32,
        "saltByteLength": 64,
        "initializationVectorByteLength": 16,
        "iterationsByteLength": 5
    },
    "secret": "verysecretstring"
}

Bottleneck

Ovaj parametar definiše konfiguraciju Bottleneck-a.

Primer

"bottleneck": {
    "getChanges": {
    }
}

Windows System Root sertifikati

Ovaj parametar definiše postavke Windows System Root sertifikata.

Primer

"win-ca": {
    "inject": "+"
}

WOPI

Ovi parametri definišu konfiguraciju WOPI protokola.

Primer

"wopi": {
"enable": false,
"host": "",
"htmlTemplate": "../../web-apps/apps/api/wopi",
"wopiZone": "external-http",
"favIconUrlWord": "/web-apps/apps/documenteditor/main/resources/img/favicon.ico",
"favIconUrlCell": "/web-apps/apps/spreadsheeteditor/main/resources/img/favicon.ico",
"favIconUrlSlide": "/web-apps/apps/presentationeditor/main/resources/img/favicon.ico",
"favIconUrlPdf": "/web-apps/apps/pdfeditor/main/resources/img/favicon.ico",
"favIconUrlDiagram": "/web-apps/apps/visioeditor/main/resources/img/favicon.ico",
"fileInfoBlockList": ["FileUrl"],
"pdfView": ["djvu", "xps", "oxps"],
"pdfEdit": ["pdf"],
"forms": ["pdf"],
"wordView": ["doc", "dotm", "dot", "fodt", "ott", "rtf", "mht", "mhtml", "html", "htm", "xml", "epub", "fb2", "sxw", "stw", "wps", "wpt", "pages", "docxf", "oform", "hwp", "hwpx", "md", "hml"],
"wordEdit": ["docx", "dotx", "docm", "odt", "txt"],
"cellView": ["xls", "xltm", "xlt", "fods", "ots", "sxc", "xml", "et", "ett", "numbers"],
"cellEdit": ["xlsx", "xlsb", "xltx", "xlsm", "ods", "csv"],
"slideView": ["ppt", "ppsx", "ppsm", "pps", "potm", "pot", "fodp", "otp", "sxi", "dps", "dpt", "key", "odg"],
"slideEdit": ["pptx", "potx", "pptm", "odp"],
"diagramView": ["vsdx", "vstx", "vssx", "vsdm", "vstm", "vssm"],
"diagramEdit": [],
"publicKey": "",
"modulus": "",
"exponent": 65537,
"privateKey": "",
"publicKeyOld": "",
"modulusOld": "",
"exponentOld": 65537,
"privateKeyOld": "",
"refreshLockInterval": "10m",
"dummy": {
  "enable": false,
  "sampleFilePath": ""
}
}

Tenanti

Ovi parametri definišu svojstva zakupaca za rad u multi-tenant režimu.

Primer

"tenants": {
    "baseDir" : "",
    "baseDomain" : "",
    "filenameConfig" : "config.json",
    "filenameSecret" : "secret.key",
    "filenameLicense" : "license.lic",
    "defaultTenant" : "localhost",
    "cache": {
        "stdTTL": 300,
        "checkperiod": 60,
        "useClones": false
    },
}

Eksterni zahtev

Ovi parametri definišu konfiguraciju eksternih zahteva.

Primer

"externalRequest": {
    "directIfIn" : {
        "allowList": [],
        "jwtToken": true
    },
    "action": {
        "allow": true,
        "blockPrivateIP": true,
        "proxyUrl": "",
        "proxyUser": {
            "username": "",
            "password": ""
        },
        "proxyHeaders": {
        }
    }
}

Usluge Document Server-a

Ovi parametri definišu podešavanja za usluge Document Server-a.

Server

Ovi parametri definišu konfiguraciju servera.

Primer

"services": {
"CoAuthoring": {
    "server": {
        "port": 8000,
        "workerpercpu": 1,
        "mode": "development",
        "limits_tempfile_upload": 104857600,
        "limits_image_size": 26214400,
        "limits_image_download_timeout": {
            "connectionAndInactivity": "2m",
            "wholeCycle": "2m"
        },
        "callbackRequestTimeout": {
            "connectionAndInactivity": "10m",
            "wholeCycle": "10m"
        },
        "healthcheckfilepath": "../public/healthcheck.docx",
        "savetimeoutdelay": 5000,
        "edit_singleton": false,
        "forgottenfiles": "forgotten",
        "forgottenfilesname": "output",
        "maxRequestChanges": 20000,
        "openProtectedFile": true,
        "isAnonymousSupport": true,
        "editorDataStorage": "editorDataRedis",
        "editorStatStorage": "",
        "assemblyFormatAsOrigin": true,
        "newFileTemplate" : "../../document-templates/new",
        "downloadFileAllowExt": ["pdf", "xlsx"],
        "tokenRequiredParams": true,
        "forceSaveUsingButtonWithoutChanges": false
    }
}
}

Podrazumevani zahtev

Ovi parametri definišu podrazumevanu konfiguraciju zahteva.

Primer

"services": {
"CoAuthoring": {
    "requestDefaults": {
        "headers": {
            "User-Agent": "Node.js/6.13",
            "Connection": "Keep-Alive"
        },
        "rejectUnauthorized": true
    }
}
}

Automatsko sastavljanje

Ovi parametri definišu konfiguraciju automatskog forsiranog čuvanja.

Primer

"services": {
    "CoAuthoring": {
        "autoAssembly": {
            "enable": false,
            "interval": "5m",
            "step": "1m"
        }
    }
}

Alati

Ovi parametri definišu konfiguraciju alata.

Primer

"services": {
    "CoAuthoring": {
        "utils": {
            "utils_common_fontdir": "null",
            "utils_fonts_search_patterns": "*.ttf;*.ttc;*.otf",
            "limits_image_types_upload": "jpg;jpeg;jpe;png;gif;bmp;svg;tiff;tif"
        }
    }
}

SQL